Okta 연동 (앱 템플릿 방식)
셀렉트 어드민은 OIN(Okta Integration Network) 공식 앱 심사 진행중입니다. 해당 기간동안 커스텀 앱 방식의 연동 가이드를 먼저 제공합니다.
English version: https://blog.selectfromuser.com/okta
한국어 버전(OIN 방식): https://blog.selectfromuser.com/ko-okta/
준비사항
- 셀렉트어드민 관리자 계정
- 도메인 설정된 셀렉트어드민 팀
- Okta 관리자 권한
편집 > 설정
에서 확인가능합니다.Okta App 준비하기
앱을 추가하고 인증방식을 선택합니다.
- Sign-in redirect URIs:
https://api.selectfromuser.com/api/connect/okta/callback
- Sign-out redirect URIs:
https://도메인입력.selectfromuser.com/logout
설치형, 구축형의 경우 이와 같이 입력합니다.
Sign-in redirect URIs:https://[설치형API주소]/api/connect/okta/callback
앱 추가가 완료되었습니다.
셀렉트 어드민 설정
편집 > 설정 > 보안 메뉴에서 통합로그인을 활성화 합니다.
- Client ID: 해당 옥타 앱 정보를 입력합니다.
- Client secret: 해당 옥타 앱 정보를 입력합니다.
- Issuer URL: 대부분의 경우 옥타 홈 URL과 일치합니다. (Security > API > Authorization Servers 에서 확인 가능)
활성화하면 로그인화면에 옥타가 표시됩니다. Okta와 SelectAdmin에 가입된 이메일 주소가 동일한 경우 별다른 설정 없이 로그인 가능합니다.
사용자 동기화
옥타를 통해 모든 셀렉트 어드민 계정을 관리 가능합니다. 이를 사용하기 위해서 옥타의 Group과 셀렉트 어드민 권한을 연결 해야합니다.
*권한 부여 및 회수 그리고 계정 발급(provisioning)을 지원합니다.
OIDC 인증결과에 groups 정보를 추가하기 위해 다음을 진행합니다.
여기에서 Scope 추가를 진행합니다.
groups
로 지정해주세요.여기에서 Claims 추가를 진행합니다.
groups
를 지정합니다.이제 셀렉트 어드민 편집 > 설정 > 보안
에서 Group mapping을 활성화 합니다.
그룹명은 셀렉트 전용으로 새로파거나, 기존 그룹을 그대로 이용합니다.
예제:
- Select Devops → Admin
- Select Developers → Edit
- Operators → View
*그룹 이름은 셀렉트에 저장되지 않으며 별도의 유효성 검증이 없습니다. 정확한 그룹 이름을 입력해주세요.
이제 어드민을 로그아웃 후, 다시 로그인하면 Okta 권한으로 재설정됩니다.
사용자가 여러개 그룹에 속해있는 경우 상위 권한이 적용됩니다. [admin, editor] → Admin
권한이 변경된 경우 감사로그에 기록이 남습니다. (Modified by Okta)
설정이 끝난 후 Force SSO을 활성화하여 Okta 이외에 다른 로그인 방법을 차단합니다.
기타 문제를 겪는 경우 채팅 또는 커뮤니티를 통해 문의바랍니다.