도움말
문의하기
aisight 도움말›관리자 가이드›계정과 로그인›외부 인증 Provider 등록
화면 안내

외부 인증 Provider 등록

인증 설정 화면 아래쪽의 Provider 등록 카드에서 외부 로그인 방식별 연결 정보를 등록합니다. 등록한 Provider를 활성화하는 방법은 인증 문서에서 다룹니다.

이 페이지 목차

위치: 관리자 > 운영 > 인증의 Provider 등록 카드

활성화와 IP 제한은 인증에서 다룹니다.

각 Provider는 "미등록" 배지가 있는 카드로 나오고, 펼치기 / 접기로 열고 닫습니다. 한 번에 한 카드만 펼쳐집니다. 펼치면 제목이 "Microsoft Entra 등록"처럼 "Provider 이름 + 등록"으로 바뀌고 오른쪽 위에 접기가 나옵니다. 카드 아래에는 연결 테스트와 저장 버튼이 있으며, 값을 바꾸기 전에는 둘 다 흐리게 비활성입니다.

Microsoft Entra

Azure 포털에서 앱을 등록하고 redirect URI에 https://aisight.example.com/api/auth/microsoft/callback 형태의 주소(실제 사이트 주소 기준)를 추가합니다.

  1. 1
    Tenant ID · Client ID Azure 포털에서 등록한 앱의 값을 그대로 넣습니다.
  2. 2
    Client Secret (Value, Secret ID 아님) 이미 저장된 secret은 다시 표시되지 않으며, 비워 두고 저장하면 기존 값이 유지됩니다.

이 카드에는 등록 정보와 함께 테스트 로그인 링크(https://aisight.example.com/api/auth/microsoft/start, 새 탭에서 열림)가 표시됩니다. 활성 Provider가 Microsoft Entra인 환경에서는 이 카드가 펼쳐진 채로 나옵니다.

LDAP

두 가지 bind 방식이 있습니다.

  • Search (service account): service account로 bind한 뒤 userSearchFilter로 사용자를 찾고, 사용자 비밀번호로 다시 bind합니다. 일반적인 OpenLDAP / FreeIPA 환경에 맞습니다.
  • Direct (사용자 ID 로 바로 bind): 검색 없이 사용자 ID로 바로 bind합니다. AD의 NetBIOS prefix(<도메인>\{username})나 UPN({username}@<도메인>) 형식입니다. 사내 도메인으로 바꿔 입력합니다.
  1. 1
    Bind 모드 두 방식의 차이는 위 설명을 참고합니다.

LDAP 카드의 연결 테스트 버튼은 "임시 비활성"으로 표시됩니다.

Pentasecurity ISign+

ISign+ 운영 콘솔에 두 URL을 등록합니다.

  • 검증 URL: https://aisight.example.com/checkauth (또는 https://aisight.example.com/api/auth/isign/callback)
  • 인증 성공 URL: https://aisight.example.com/agentProc
  1. 1
    접근 거부 안내 문구 ISign+ 인증은 됐지만 계정이 없거나(미등록) 비활성인 사용자에게 로그인 화면에서 보여 줄 문구입니다.

HTTP Auth

외부 인증 서버의 확인 엔드포인트를 호출하고, 그 JSON 응답을 사용자 정보로 삼아 세션을 발급합니다.

  1. 1
    메서드 · auth-check URL 방식은 GET 또는 POST 중에서 고릅니다.
  2. 2
    쿠키 이름 (선택) 지정하기 전에 아래 주의 사항을 확인하세요.
  3. 3
    실패 시 로그인 URL (선택) 입력하면 인증 실패 화면에 로그인하러 가기 버튼이 나옵니다. 비우면 메시지만 표시됩니다.
쿠키 이름을 지정할 때 주의하세요

게이트웨이가 발급하는 토큰 쿠키를 지정하면 만료 뒤 모든 사용자가 로그인하지 못할 수 있습니다. 쿠키 이름을 지정하기 전에 연결 테스트로 실제 쿠키 목록을 먼저 확인하세요.

SAML 2.0

화면 안내: IdP(Keycloak · Azure AD · ADFS · Okta 등)로 사용자를 인증하며 aisight가 SAML 서비스 공급자(SP)가 됩니다. 아래 7단계를 순서대로 완료합니다. 운영 환경은 서버 측 HTTPS를 전제로 하고, SAML은 모바일 앱 로그인을 지원하지 않습니다(모바일은 로컬 비밀번호로 처리).

단계 내용
1단계 aisight 반환 URL(선택), SAML 엔터티 ID(필수), SAML 인증서 파일·키 파일(선택). 자체 서명 인증서 생성 버튼이 있으며, 개인키는 다시 표시되지 않습니다. 엔터티 ID는 기본값이 사이트의 …/api/auth/saml/metadata 주소이며 "한 번 정하면 바꾸지 마세요"라고 안내됩니다.
2단계 XML 메타데이터 파일 다운로드(1단계 저장 후 가능). 엔터티 ID, ACS URL, 메타데이터 URL, SLO 콜백 URL이 읽기 전용으로 표시됩니다.
3단계 IdP에 aisight를 SP로 추가한 뒤 IdP 메타데이터 XML을 내보냅니다.
4단계 IdP 메타데이터 XML을 업로드하거나, IdP 엔터티 ID, IdP SSO URL, IdP SLO URL(선택), IdP 서명 인증서(PEM)를 입력합니다.
5단계 어설션 속성명 매핑: 사용자 이름(기본 username), 표시 이름(displayName), 이메일(email, aisight 로그인 ID(users.email) 매칭 키), 도메인(선택).
6단계 첫 로그인 시 사용자 자동 생성 (JIT)(기본 켜짐): aisight 에서 SAML 로그아웃 사용 (SLO)(기본 꺼짐). SAML 로그아웃 리디렉션(기본 /login).
7단계 AuthnContextClassRefs(선택), 접이식 "고급 설정 (서명 검증 · NameID 형식 · IdP-initiated)", 연결 테스트, 저장.

마지막 수정: