회사의 ID 관리 시스템과 연결
(SSO·SCIM)

ID 관리 시스템별 안내

• Okta: SSO(OpenID Connect)와 SCIM.
• Microsoft Entra ID: SSO(OpenID Connect)와 SCIM. SCIM에는 Entra ID P1 이상이 필요합니다.
• Google Workspace: SSO(OpenID Connect). SCIM은 쓸 수 없으므로, 자동 등록과 명단 한꺼번에 등록으로 대신합니다.

OpenID Connect를 지원하는 다른 ID 관리 시스템도 이 페이지의 값으로 연결할 수 있습니다.

먼저 정할 것

1. 누구를 넣을지. ID 관리 시스템에서 Aiyori 앱에 할당한 사람과 그룹만 들어옵니다(전원이 아닙니다). SCIM을 쓰면 할당한 부서·입사 연차 등의 그룹이 그대로 Aiyori의 그룹이 됩니다.
2. 로그인 방식. 회사 계정만 허용할지, 비밀번호로도 들어올 수 있게 할지 정합니다. 큰 회사에는 회사 계정만 허용하는 것을 권합니다(퇴사한 사람이 비밀번호로 들어올 수 없게 됩니다).
3. 명단을 넣는 방식. SCIM으로 자동으로 넣기(Okta·Microsoft Entra ID), 회사 계정으로 처음 로그인한 사람을 자동으로 등록하기, 표(CSV)로 매달 한꺼번에 등록하기 중 하나입니다. Google Workspace는 SCIM이 없으므로 뒤의 두 가지입니다.

ID 관리 시스템에 입력할 Aiyori의 값

리디렉션 URI와 SCIM 기본 URL은 강사 화면의 “설정” → “회사의 ID 관리 시스템과 연결”에도 나와 있습니다(복사 버튼 포함). 설정을 바꿀 수 있는 사람은 조직의 관리자(조직을 만든 사람)뿐입니다.

리디렉션 URI

https://app.aiyori.app/api/web/sso/callback
ID 관리 시스템의 Aiyori 앱에 등록합니다. 한 글자라도 다르면 로그인할 수 없습니다.

SCIM 기본 URL

https://app.aiyori.app/api/scim/v2
Okta의 SCIM connector base URL, Entra ID의 Tenant URL에 입력합니다.

SCIM 키

“회사의 ID 관리 시스템과 연결”의 “키 만들기” 버튼으로 만듭니다. 만들 때 한 번만 표시됩니다(조직당 5개까지). Okta의 Bearer token, Entra ID의 Secret Token에 입력합니다.

로그인 입구(회사 포털의 타일용)

https://app.aiyori.app/api/web/sso/start?code=(조직 코드)
Okta의 Initiate login URI, Entra ID의 Home page URL에 입력하면, 회사 포털의 타일에서 조직 코드를 입력하지 않고 회사 로그인으로 바로 갈 수 있습니다.

Aiyori에 입력할 값

“회사의 ID 관리 시스템과 연결”의 “SSO” 탭에 입력하고 “저장” 버튼을 누릅니다.

발급자 URL(Issuer)

ID 관리 시스템마다 다릅니다(Okta: https://(조직).okta.com, Microsoft Entra ID: https://login.microsoftonline.com/(테넌트 ID)/v2.0, Google Workspace: https://accounts.google.com).

클라이언트 ID

ID 관리 시스템에 만든 앱의 ID입니다.

클라이언트 시크릿

ID 관리 시스템에 만든 앱의 시크릿입니다. 암호화해서 저장하며, 저장한 뒤에는 화면에 표시하지 않습니다.

허용할 메일 주소 도메인

회사 메일 도메인(예: example.com)을 한 줄에 하나씩 입력합니다. 반드시 입력해 주세요. 입력하지 않으면 ID 관리 시스템이 통과시킨 사람은 누구든 들어올 수 있습니다(Google Workspace는 입력하지 않으면 저장할 수 없습니다).

자동 등록

SCIM을 쓰지 않을 때(Google Workspace 등)는 “아직 등록되지 않은 사람이 로그인하면 수강자로 등록하기” 항목을 켭니다. 도메인이 맞는 사람만 등록됩니다.

비밀번호 로그인을 끄고 회사 계정만 허용하기

한 사람이 회사 계정으로 들어올 수 있는지 확인한 뒤에 켭니다.

저장할 때 Aiyori는 발급자의 설정 정보(발급자 URL 뒤에 /.well-known/openid-configuration을 붙인 것)를 읽습니다. 읽을 수 없으면 저장할 수 없습니다. 발급자는 https로 시작하는 공개 URL만 쓸 수 있습니다(사내 이름·IP 주소는 쓸 수 없습니다).

저장한 뒤 “직접 로그인해 보기”의 “내 회사 계정으로 시험하기” 버튼으로, 관리자의 회사 계정으로 로그인해 Aiyori로 돌아올 수 있는지 확인할 수 있습니다(수강자로는 등록되지 않습니다).

수강자의 로그인

• 교육 링크의 로그인 화면에서 “회사 계정으로 로그인” 버튼을 누르고 조직 코드를 입력 → 회사 로그인 화면 → Aiyori로 돌아옵니다.
• 회사 포털(Microsoft My Apps·Okta 대시보드)에 타일을 둘 때는 위의 로그인 입구 URL을 씁니다. 조직 코드를 입력하지 않고 들어갈 수 있습니다.
• 사람을 찾는 순서는 전에 회사 계정으로 연결한 사람 → 회사 메일 주소가 같은 수강자입니다(Entra ID는 SCIM의 userName이 UPN과 같은 수강자도). 둘 다 없으면 자동 등록 설정이 켜져 있을 때만, 도메인이 맞는 사람을 등록합니다.
• 들어갈 수 없을 때는 이유가 화면에 나옵니다(도메인이 다름·아직 등록되지 않음·회사 설정으로 정지 중·이용 종료).

SCIM으로 일어나는 일

부서(department)·사번(employeeNumber) 속성은 SCIM에서 쓰지 않습니다(그룹으로 나눕니다). 사번으로 같은 사람을 구별하고 싶을 때는 표(CSV)로 한꺼번에 등록하기를 씁니다.

수강자를 이용 종료 처리할지(30일 뒤에 기록이 삭제됨)는 ID 관리 시스템이 아니라 강사가 수강자 페이지에서 정합니다.

키가 유출되었을 때는 Aiyori 화면에서 그 키의 “비활성화” 버튼을 누르고, 새 키를 만들어 ID 관리 시스템에 다시 입력합니다. 멈추는 것은 동기화뿐이며, 수강자의 로그인은 멈추지 않습니다.

잘 안 될 때