Okta 연동 설정

​

개요

• account.locked — 계정 잠김
• mfa.factor.activated — 추가 MFA 요소 활성화
• auth.login.failed — 로그인 실패

​

연결 방식 선택

​

옵션 A — API 토큰(SSWS)

​

Living Security에 필요한 정보

​

사전 요구 사항

• 서비스 계정 사용자를 생성하고, 관리자 역할을 할당하고, API 토큰을 생성하려면 Okta Super Administrator여야 합니다.

​

문제 해결

​

옵션 B — OAuth 2.0 서비스 애플리케이션

1. 클라이언트 ID - Okta API Services 애플리케이션의 고유 식별자입니다.
2. 개인 키(JWK) - JSON Web Key 형식의 RSA 개인 키이며, 해당 공개 키가 Okta 애플리케이션에 등록되어 있어야 합니다.
3. Okta 도메인 - 전체 호스트 이름이 아닌 Okta 테넌트 서브도메인만 입력합니다(예: dev-12345678).
4. 범위 - 공백으로 구분된 Okta Management API 범위 목록입니다(예: okta.users.read okta.logs.read).

​

사전 요구 사항:

• Okta 계정이 있어야 합니다. developer.okta.com에서 무료 개발자 계정에 가입할 수 있습니다.

​

1단계: Okta API Services 애플리케이션 생성

1. Okta Admin Console에 로그인합니다.
2. 왼쪽 사이드바에서 Applications > Applications로 이동합니다.
3. Create App Integration을 클릭합니다.
4. 로그인 방법으로 API Services를 선택하고 Next를 클릭합니다.

5. 애플리케이션 이름을 지정하고 Save를 클릭합니다.
6. 애플리케이션의 General 탭에서 Client ID를 확인합니다. 마지막 단계에서 필요합니다.
7. Client authentication을 Public key / Private key로 설정합니다. okta.* 범위는 이 인증 방식에서만 지원됩니다.

8. **Proof of possession (DPoP)**을 비활성화합니다. 지원되지 않습니다.

​

2단계: RSA 키 쌍 생성 및 등록

Okta 키 생성기 사용

1. Admin Console에서 API Services 애플리케이션을 엽니다.
2. General 탭으로 이동하여 PUBLIC KEYS 섹션까지 스크롤합니다.
3. Add Key를 클릭한 다음 Generate new key를 선택합니다.
4. Save를 클릭합니다. Okta가 키 쌍을 생성하고 **Private Key (JWK)**를 한 번만 표시합니다.
5. 개인 키 JSON을 즉시 복사하여 저장하십시오. 다시 표시되지 않습니다.

6. 공개 키는 애플리케이션에 자동으로 등록됩니다.

직접 키 생성

const { generateKeyPairSync } = require('crypto');
const { privateKey, publicKey } = generateKeyPairSync('rsa', { modulusLength: 2048 });

const privateJwk = privateKey.export({ format: 'jwk' });
const publicJwk  = publicKey.export({ format: 'jwk' });

// Assign a kid — must match between private and public JWK
const kid = require('crypto').randomUUID();
privateJwk.kid = kid;
publicJwk.kid  = kid;

console.log('=== PUBLIC JWK (upload to Okta) ===');
console.log(JSON.stringify(publicJwk, null, 2));
console.log('\n=== PRIVATE JWK (paste into the Living Security Platform) ===');
console.log(JSON.stringify(privateJwk));

1. Admin Console에서 API Services 애플리케이션을 엽니다.
2. General 탭으로 이동하여 PUBLIC KEYS 섹션까지 스크롤합니다.
3. Add Key를 클릭하고, 위 스크립트가 출력한 공개 JWK JSON을 붙여넣은 다음 Save를 클릭합니다.

​

3단계: Okta 도메인 확인

• Admin Console에서 브라우저 주소 표시줄에 https://dev-12345678-admin.okta.com과 같은 URL이 표시됩니다.
• Okta 도메인은 dev-12345678.okta.com이 아니라 서브도메인만(예: dev-12345678) 입력합니다.
• 또는 Admin Console에서 Settings > Account로 이동하여 Okta 도메인을 확인한 다음 서브도메인 부분을 사용합니다.

​

4단계: 애플리케이션에 API 범위 부여

1. Admin Console에서 Applications > Applications로 이동하여 애플리케이션을 엽니다.
2. Okta API Scopes 탭을 클릭합니다.
3. 연동에 필요한 범위인 okta.users.read 및 okta.logs.read을 부여합니다.

​

5단계: 애플리케이션에 관리자 역할 할당

1. Admin Console에서 Security > Administrators로 이동합니다(또는 Applications > Applications > 해당 앱 > Admin roles로 이동합니다).
2. Add administrator assignment를 클릭하고 API Services 애플리케이션을 선택합니다.

3. Read-Only Administrator 역할(필요한 범위에 따라 그 이상의 역할)을 할당합니다.
4. Save를 클릭합니다.

​

6단계: Living Security Platform에 자격 증명 입력

1. Okta(Client Credentials) 인증이 필요한 양식을 엽니다.
2. 클라이언트 ID를 입력합니다.
3. **개인 키(JWK)**를 붙여넣습니다. 위 스크립트에서 생성된 전체 JSON 객체(한 줄 또는 서식이 적용된 형태)를 붙여넣습니다.
4. Okta 도메인을 테넌트 서브도메인만(예: dev-12345678) 입력합니다.
5. 범위를 공백으로 구분된 목록(예: okta.users.read okta.logs.read)으로 입력합니다.
6. 양식을 제출하면 인증이 성공적으로 완료됩니다.