> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SSO 및 SCIM 프로비저닝 설정하기

> ID 공급자를 AhaSlides에 연결해 싱글 사인온을 설정하고, 이메일 도메인에 SSO를 필수로 지정하며, SCIM 2.0으로 팀 멤버를 자동 프로비저닝하세요.

싱글 사인온(SSO)을 사용하면 팀원이 AhaSlides 비밀번호 대신 조직의 ID 공급자를 통해 AhaSlides에 로그인할 수 있으며, SCIM 프로비저닝은 같은 공급자에서 팀원의 계정을 생성하고 비활성화합니다. IT 팀이 AhaSlides 접근 권한을 한곳에서 관리해야 한다면 두 가지를 함께 사용하세요.

## SSO와 SCIM을 시작하기 전에

SSO와 SCIM은 모든 플랜에서 제공되지는 않습니다. 팀에 추가하려면 [Enterprise 양식](https://ahaslides.com/enterprise/) 또는 [hi@ahaslides.com](mailto:hi@ahaslides.com)으로 문의해 주세요.

팀 설정에는 SSO나 SCIM 화면이 없습니다. 고객님이 ID 공급자를 설정하면 AhaSlides 쪽 설정은 저희 팀이 완료해 드립니다.

| 단계 | 고객 | AhaSlides |
| - | - | - |
| ID 공급자 연결 | ID 공급자에서 AhaSlides 앱을 만들고 세부 정보를 저희에게 보냅니다 | 공급자 이름을 보내 드리고 팀의 SSO를 켭니다 |
| 이메일 도메인 연결 | 팀이 로그인에 사용하는 도메인을 알려 줍니다 | 해당 도메인을 팀에 연결합니다 |
| SSO 전용 로그인 필수화 | 켜 달라고 요청합니다 | 연결된 도메인에 대해 켜거나 끕니다 |
| SCIM 프로비저닝 | ID 공급자에 SCIM URL과 토큰을 입력합니다 | SCIM 토큰을 생성합니다 |

ID 공급자의 관리자 권한과 멤버가 가입할 AhaSlides [팀](/ko/teams-and-enterprise/managing-your-team-members)이 필요합니다.

## ID 공급자 연결하기

AhaSlides는 Okta 같은 모든 SAML 2.0 ID 공급자와 Microsoft Entra ID에서 작동합니다.

<Steps>
  <Step title="SSO를 켜 달라고 요청">
    팀 이름과 사용하는 이메일 도메인을 알려 주세요. 저희가 **공급자 이름**을 회신해 드립니다. 이는 SSO 주소에 표시되는 조직의 짧은 식별자입니다.
  </Step>

  <Step title="ID 공급자에서 AhaSlides 앱 만들기">
    SAML 2.0 공급자라면 다음 값으로 SAML 앱을 만드세요.

    | 필드 | 값 |
    | - | - |
    | 싱글 사인온 URL (ACS URL) | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | 대상 URI (SP 엔터티 ID) | 공급자 이름과 함께 보내 드리는 값 |
    | Name ID | 사용자의 이메일 주소 |

    서비스 공급자 메타데이터는 `https://presenter.ahaslides.com/p/saml/your-provider-name/metadata`에서 다운로드할 수도 있습니다.

    Microsoft Entra ID라면 애플리케이션을 등록하세요. 추가할 리디렉션 URI는 저희가 보내 드립니다.
  </Step>

  <Step title="ID 공급자 세부 정보 보내기">
    SAML이라면 ID 공급자 로그인 URL, 발급자, X.509 서명 인증서 또는 이를 담은 메타데이터 파일을 보내 주세요. 이름과 성이 채워지길 원하면 어떤 속성에 담겨 있는지 알려 주세요.

    Microsoft Entra ID라면 테넌트 ID, 클라이언트 ID, 클라이언트 시크릿을 보내 주세요.
  </Step>

  <Step title="사용자 할당 및 테스트">
    AhaSlides를 사용할 사람에게 앱을 할당하세요. 연결이 활성화되었다고 알려 드리면 SSO로 로그인하기의 단계를 따라 테스트하세요.
  </Step>
</Steps>

## 이메일 도메인을 팀에 연결하기

SSO는 팀에 연결된 도메인의 이메일 주소에서만 작동하며, 해당 도메인은 저희가 연결해 드립니다. 멤버가 로그인에 사용하는 모든 도메인을 알려 주세요.

* 하나의 도메인은 하나의 팀에만 연결할 수 있습니다.
* 연결되지 않은 도메인의 이메일을 쓰는 사람은 SSO로 로그인할 수 없습니다.

## SSO로 로그인하기

<Steps>
  <Step title="SSO 페이지 열기">
    [AhaSlides 로그인 페이지](https://presenter.ahaslides.com/pages/login)에서 **SSO로 로그인** (Log in with SSO)을 클릭합니다.
  </Step>

  <Step title="회사 이메일 입력">
    이메일 주소를 입력하고 **로그인** (Log in)을 클릭합니다. AhaSlides가 조직의 로그인 페이지로 이동시킵니다.
  </Step>

  <Step title="조직 계정으로 로그인">
    그곳에서 로그인하면 AhaSlides로 이동합니다.
  </Step>
</Steps>

SSO로 처음 로그인하면 AhaSlides가 계정이 없는 경우 계정을 만들고 **멤버** (Member) 역할로 팀에 추가합니다. AhaSlides 비밀번호는 따로 설정하지 않습니다.

## 도메인에 SSO 필수로 지정하기

기본적으로 SSO를 설정하면 로그인 방법이 하나 추가될 뿐 다른 방법이 사라지지는 않습니다. 이미 AhaSlides 비밀번호가 있는 사람은 계속 사용할 수 있습니다. 조직에서 SSO만 허용해야 한다면 연결된 도메인에 SSO 전용 로그인을 켜 달라고 요청하세요. 먼저 정상 작동하는 SSO 연결이 있어야 합니다.

켜고 나면 연결된 도메인의 이메일 주소를 사용하는 사람에게 다음과 같이 표시됩니다.

| 위치 | 표시되는 내용 |
| - | - |
| 로그인, 회원가입, 비밀번호 찾기 페이지 | 이메일을 입력하면 **소속 조직에서 SSO(싱글 사인온)를 요구합니다** (Your organisation requires single sign-on)라는 제목의 창이 표시됩니다. **SSO로 계속하기** (Continue with SSO)를 누르면 SSO 페이지로 이동하고, **다른 이메일 주소 사용** (Use a different email)을 누르면 입력란이 지워집니다. |
| SSO 페이지 | 이메일이 채워진 상태로 "소속 조직에서 SSO(싱글 사인온)를 요구합니다. 아래에서 계속 진행하여 로그인하세요."라는 메시지 (Your organisation requires single sign-on. Please continue below to sign in.) |
| 계정 설정 | **비밀번호** (Password) 섹션이 없고 이메일 주소를 수정할 수 없음 |

이는 아직 팀에 가입하지 않은 사람을 포함해 연결된 도메인의 모든 주소에 적용됩니다.

## SCIM 사용자 프로비저닝 설정하기

SCIM을 사용하면 ID 공급자가 AhaSlides 계정을 대신 생성, 업데이트, 비활성화합니다. AhaSlides는 사용자에 대해 SCIM 2.0을 지원합니다.

<Steps>
  <Step title="SCIM 토큰 요청">
    저희가 토큰을 생성해 보내 드립니다. 안전한 곳에 보관하세요. 저희는 토큰의 해시만 저장하므로 다시 보여 드릴 수 없습니다. 분실했거나 노출되었을 수 있다면 새 토큰을 요청해 주세요.
  </Step>

  <Step title="ID 공급자에 연결 세부 정보 입력">
    | 설정 | 값 |
    | - | - |
    | SCIM 기본 URL | `https://presenter.ahaslides.com/api/scim/v2` |
    | 인증 | Bearer 토큰, `Authorization: Bearer your-token` 형식으로 전송 |
    | 고유 식별자 | `userName` |
  </Step>

  <Step title="사용자 속성 매핑">
    지원되는 SCIM 속성에 나열된 속성을 매핑한 다음 사용자 생성, 업데이트, 비활성화를 켭니다. 비밀번호 동기화는 꺼 두세요.
  </Step>

  <Step title="사용자 할당">
    AhaSlides 앱에 사람이나 그룹을 할당하세요. 그러면 ID 공급자가 해당 계정을 만듭니다.
  </Step>
</Steps>

### 지원되는 SCIM 속성

| SCIM 속성 | 용도 |
| - | - |
| `userName` | 멤버의 이메일 주소. 사용자를 식별하며 소문자로 저장됩니다. |
| `name.givenName`, `name.familyName` | 이름과 성 |
| `displayName` | `name`이 전송되지 않을 때만 이름에 사용: 첫 단어는 이름, 나머지는 성이 됩니다 |
| `active` | `true`는 계정을 활성 상태로 유지하고, `false`는 비활성화하며 멤버를 로그아웃시킵니다 |
| `externalId` | 응답에 변경 없이 그대로 반환됩니다 |

### 지원되는 SCIM 작업

| 메서드 | 엔드포인트 | 기능 |
| - | - | - |
| `GET` | `/Users` | 팀의 사용자 목록을 가져옵니다. `filter=userName eq "name@example.com"`, `startIndex`, `count`(기본값 10)를 받습니다. |
| `GET` | `/Users/{id}` | 사용자 한 명을 반환합니다 |
| `POST` | `/Users` | 사용자를 생성합니다 |
| `PATCH` | `/Users/{id}` | `active` 등 일부 속성을 업데이트합니다 |
| `PUT` | `/Users/{id}` | 사용자의 속성을 교체합니다 |

그룹과 `DELETE`는 지원되지 않습니다. 누군가의 접근 권한을 없애려면 `active`를 `false`로 설정하세요. 대부분의 ID 공급자는 사용자 할당을 해제할 때 이 값을 보냅니다.

SCIM으로 생성된 사용자는 **멤버** (Member) 역할로 팀에 가입합니다. 이메일이 이미 팀에 속하지 않은 AhaSlides 계정에 속해 있다면 새 계정을 만드는 대신 그 계정이 팀에 추가됩니다.

### 팀 페이지에서 달라지는 점

SCIM이 켜져 있는 동안에는 ID 공급자에서 멤버십을 관리합니다. 팀 페이지에는 **초대** (Invite) 버튼이 더 이상 나타나지 않으며, 멤버는 계정 설정에서 자신의 이메일 주소를 수정할 수 없습니다.

## SSO 및 SCIM 문제 해결

### SCIM 연결 테스트에서 401이 반환됩니다

토큰이 없거나, 잘못 입력되었거나, 더 이상 활성 상태가 아닙니다. 토큰이 아무것도 덧붙이지 않은 Bearer 토큰으로 전송되는지 확인하세요. 그래도 실패하면 새 토큰을 요청해 주세요.

### 프로비저닝된 멤버의 이름이 잘못되었거나 비어 있습니다

`name.givenName`과 `name.familyName`을 보내세요. `displayName`만 전송되면 AhaSlides는 첫 번째 공백을 기준으로 나누므로 세 부분 이상으로 된 이름은 잘못 나뉩니다.

### 멤버가 SSO로 로그인할 수 없습니다

멤버가 ID 공급자에서 AhaSlides 앱에 할당되어 있는지, 이메일 도메인이 연결을 요청하신 도메인인지 확인하세요. 새 도메인을 추가했다면 저희가 연결할 수 있도록 알려 주세요.

## 자주 묻는 질문

<AccordionGroup>
  <Accordion title="하나의 이메일 도메인을 두 팀에 연결할 수 있나요?">
    아니요. 각 도메인은 하나의 팀에만 속하므로 해당 도메인의 모든 사람이 같은 팀으로 로그인합니다.
  </Accordion>

  <Accordion title="SCIM이 AhaSlides 계정을 삭제하나요?">
    아니요. SCIM은 계정을 비활성화하고 멤버를 로그아웃시킵니다. 프레젠테이션은 계정에 그대로 남습니다.
  </Accordion>

  <Accordion title="SSO를 사용하는데 비밀번호를 잊어버렸어요. 어떻게 하나요?">
    재설정할 AhaSlides 비밀번호가 없습니다. **SSO로 로그인** (Log in with SSO)으로 로그인하세요. SSO 계정에서 비밀번호 재설정이 어떻게 처리되는지는 [비밀번호 변경 또는 재설정하기](/ko/account-management/change-or-reset-your-password)를 참고하세요.
  </Accordion>
</AccordionGroup>

**궁금한 점이 있으신가요?**

지원팀에 문의해 주세요. 로그인한 상태라면 대시보드 오른쪽 아래의 채팅 아이콘을 사용하시고, 그렇지 않다면 [여기에서 문의하시거나](https://ahaslides.com/contact-us/) [hi@ahaslides.com](mailto:hi@ahaslides.com)으로 이메일을 보내 주세요.

다른 사용자와 소통하고 싶으신가요? [AhaSlides 커뮤니티](https://community.ahaslides.com/)에 참여해 팁을 공유하고, 기능을 제안하고, 다른 사람들이 청중의 참여를 이끄는 방법을 살펴보세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.