SSO 연동하기 (Okta)

Hackle SSO Integration Guide with Okta

이 가이드는 Hackle에 Okta를 통한 SSO(Single Sign-On) 설정 방법을 안내합니다.

사전 요구사항

• Okta 관리자 계정

• Hackle 관리자 계정

• Hackle Enterprise 플랜 이상의 구독

1. Okta에서 애플리케이션 설정

1.1 Okta 관리자 대시보드에서 새 애플리케이션 생성

1. Okta 관리자 포털에 로그인합니다

2. Applications > Applications로 이동합니다

3. 'Create App Integration' 버튼을 클릭합니다

4. Sign-in method에서 'SAML 2.0'을 선택합니다

5. 'Next'를 클릭합니다

1.2 SAML 설정

General Settings에서 다음 정보를 입력합니다:

• App name: "Hackle"

• App logo: 선택사항입니다. Hackle 로고를 업로드할 수 있습니다

SAML Settings에서 다음 정보를 입력합니다:

Single Sign On URL: https://app.hackle.io/sso/saml2/acs
Audience URI (SP Entity ID): https://app.hackle.io/sso/saml2/metadata
Name ID format: EmailAddress
Application username: Email

1.3 속성 매핑 설정

다음과 같이 SAML 속성을 매핑합니다:

• First Name: user.firstName

• Last Name: user.lastName

• Email: user.email

• Role: user.role (선택사항)

2. Hackle에서 SSO 설정

2.1 Hackle 관리자 설정

1. Hackle 대시보드에 로그인합니다

2. Settings > Authentication으로 이동합니다

3. 'Configure SSO' 버튼을 클릭합니다

2.2 Okta 메타데이터 설정

Okta에서 다음 정보를 복사하여 Hackle에 입력합니다:

• Identity Provider Single Sign-On URL

• Identity Provider Issuer

• X.509 Certificate

3. 연동 테스트

3.1 테스트 사용자 설정

1. Okta에서 테스트용 사용자를 생성하거나 기존 사용자를 선택합니다

2. 해당 사용자에게 Hackle 애플리케이션을 할당합니다

3.2 SSO 로그인 테스트

1. 프라이빗 브라우저 창을 엽니다

2. Hackle SSO 로그인 URL로 이동합니다

3. Okta 크레덴셜을 사용하여 로그인을 시도합니다

4. 성공적으로 Hackle로 리디렉션되는지 확인합니다

4. 문제 해결

일반적인 문제 및 해결 방법:

• SAML Response 오류

  • Okta의 속성 매핑이 올바른지 확인

  • 인증서가 유효한지 확인

• 로그인 실패

  • 사용자에게 적절한 권한이 할당되었는지 확인

  • Hackle 계정이 활성화되었는지 확인

5. 보안 설정 (선택사항)

추가 보안을 위한 권장 설정:

• IP 화이트리스팅 구성

• 세션 타임아웃 설정

• 강력한 비밀번호 정책 적용

지원 및 문의

통합 과정에서 문제가 발생하면 다음 채널을 통해 지원을 받을 수 있습니다

• Hackle 기술지원팀: [e-mail]

• 기술문서: docs.hackle.io