Okta와 AD 연동하기 (Ad to Okta)

![adtookta.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/2a989e47-1696-7474-8d40-aac2211b37cc.png)

#TL;DR
> [Okta와 Active Directory(AD)](https://www.okta.com/integrations/active-directory/#overview) 의 연동 방법을 스크린샷 위주로 기록해보았습니다.
> 1. Okta AD Agent 설치
> 2. AD의 사용자 계정을 Okta로 당겨오는 과정

# 사전 조건
- Okta와 Active Directory(AD) 각각 시스템에 Administrator 권한 필요

# Okta AD Agent 설치 및 설정
Okta에 AD를 연동하기 위해서 AD 서버에 AD Agent 설치가 필요합니다.
※ AD 서버에서 웹 브라우저를 통해 Okta 사이트에 접속하여 진행하였습니다.

Okta 어드민 로그인 > Directory > Directory Integrations > Add Active Directory > Set Up Active Directory
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/0b9eaa04-6274-cd7d-d59f-73dd11439839.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/7c1b7c3e-5fd8-ad85-0232-eb7155e38463.png)

Download Agent 클릭하면 `OktaADAgentSetup-3.6.1.exe` 다운로드 됩니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/6effe5fa-48e6-62cb-8e50-9272d842877b.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/02af6c6c-7a0b-cedd-a9bc-52bfcdcb4374.png)
다음 단계는 Okta AD Agent(= `OktaADAgentSetup-3.6.1.exe`) 설치입니다.
해당 설치가 완료되기 전까지는 `Wating for the agent installer to update this page...` 라는 메시지가 보입니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/2293e8e4-4182-c436-0075-a685840c07aa.png)
`OktaADAgentSetup-3.6.1.exe` > Next > Install
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/885154a6-eddb-2360-6a15-2efd0ab9797b.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/f38ae6f2-a7b0-6bab-f67d-e4ab08c0db28.png)
AD 서버의 Domain 값을 입력합니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/b1bed25e-c3c0-c81b-2b5a-4b73d119bd1b.png)
Use an alternate account that I specify > AD 서버의 어드민 계정 아이디와 비밀번호를 입력합니다. > Next
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/a9c0cca2-08df-ae6e-9ced-519de99f2a85.png)
Proxy 설정은 스킵합니다. > Next
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/dda61fbe-9244-ac1a-e678-17aa12943531.png)
Production > Subdomain은 Okta URL의 서브도메인 값을 입력합니다. > Next
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/b6a69e3e-61f1-5d06-1ead-00ca7c3ebd24.png)
Okta에 로그인을 유도하는 팝업 > Okta 어드민 계정으로 로그인 > Allow Access
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/1922cf69-43e8-117a-66cd-2e12cdc324a8.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/204fbee8-7124-a145-497a-f6efdd1f13f4.png)
Finish > `OktaADAgentSetup-3.6.1.exe` 설치를 마무리합니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/6f87100a-dec3-3cf5-4e47-7b73214ea823.png)

이제 Okta에 접속하여, AD Agent 설치완료 알림 팝업을 확인하고 Next 클릭하여 다음 단계로 이동합니다.
`Wating for the agent installer to update this page..` 메시지가 `Setup information retrieved!` 로 변경되었습니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/87f9f0b3-2f8d-e2e0-b146-7cdcc4f7efcd.png)

Okta에 맵핑 시킬 AD의 User와 Group의 OU를 각각 맵핑합니다. (체크박스 체크)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/1cff6cf6-f768-af97-0470-f9fc36b3d348.png)
Okta username format의 기본값인 UPN 으로 하고 다음 단계로 진행합니다. (Okta username format 은 이후에도 수정/변경 가능)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/713e367f-458f-63ca-d3b0-f31f48e3284d.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/cd3f10e9-1f78-efa2-e4cc-8c690abeb737.png)

AD의 Attribute Name 값을 확인하고 Okta와 연동할 Attribute값을 선별하여 체크한 후 Next 로 다음 단계로 넘어갑니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/5987e8e7-539f-9400-ffac-5989c4145585.png)

Done 클릭하여 설치를 마무리합니다.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/c20602ef-4082-2e21-c7fd-b9faadce0aa4.png)

# AD 사용자 계정 Okta로 가져오기
위 과정으로 AD와 Okta 연결된 환경을 구성하였습니다.
이제 AD의 사용자를 Okta로 가져오는 설정입니다.

Okta 어드민 로그인 > Directory > Directory Integrations > AD 선택 > Provisioning > To Okta
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/a94af1d5-0a7c-e8b7-4658-cc93c43c5513.png)
General > Edit > Okta username format > Okta에 로그인에 사용자 ID값 맵핑 (예: E-mail : appuser.exPrimaryMail) > Save
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/8ce8ed2f-103e-800d-6a87-f8da8989cf9a.png)

자! 이제 Okta로 AD 사용자 당겨와 봅니다.
Okta 어드민 로그인 > Directory > Directory Integrations > AD 선택 > Import > Import Now
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/681f191b-e0ff-2d9f-ddfd-8c528757a246.png)

Full import > Import > Progress 바 확인 > 스캔된 AD 유저와 그룹 확인 및 OK
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/fb5055ae-ece6-a1c7-6fc9-c3dee0a922b2.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/2780cc6e-a1a6-86d2-b30b-4b8edde14973.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/b1c85d46-4e94-39d5-f69c-5128ce416eb5.png)

Okta에 이미 존재하는 계정이면 EXACT, 신규 계정이라면 NEW > 가져올 사용자 체크 > Confirm Assignments > Confirm
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/fe3f4b81-3b88-de9e-2802-da1af9343231.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/ac596abf-cad1-b293-25fb-e95011882226.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/d21965aa-abcc-6bc4-ba91-94742c86820f.png)

Okta 어드민 로그인 > Directory > Directory Integrations > AD 선택 > Assignments 에서 확인 (예: ck l)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/5fa88f89-260a-cbd4-5e6c-6a2cb6c2da1c.png)

또한 Okta 에 존재하는 전체 사용자 계정을 확인할 수 있는 People 에서 확인 가능합니다.
Okta 어드민 로그인 > Directory > People
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/144058/2268c4c9-ed1d-330a-cba1-a5d8bdeeec42.png)

드디어 AD 사용자 계정을 Okta로 당겨왔습니다.

정말 신기한 부분이 있는데요. 
> Okta에 당겨와진 AD 사용자는 Okta 로그인 시, AD의 Password를 그대로 사용할 수 있습니다.
> `Okta AD Agent`는 Password까지 동기화 해줌을 알 수 있습니다.

# 참고
- [Okta 초간단 사용기](https://qiita.com/leechungkyu/items/b68051118d07c9ff5197)
- https://help.okta.com/en/prod/Content/Topics/Directory/ad-agent-main.htm