airfocus 용 SAML 개요

작성자::  Shanna S
마지막으로 업데이트되었습니다:  

SAML 통합을 활용하여 airfocus를 IdP에 연결하면 계정 사용자가 SAML SSO를 사용하여 IdP를 통해 빠르고 안전하게 인증할 수 있습니다.

이 문서의 목적은 관리자가 airfocus 내에서 SAML 연결을 설정하는 과정을 안내하는 것입니다. 고급 설정에 대해 다루기 전에 일반적인 정보와 특정 IDP를 다루는 자료 링크부터 소개하겠습니다.

airfocus 기업 플랜 구독 고객이라면 누구나 이용할 수 있습니다.

SAML SSO 소개

airfocus를 ID 공급자(IdP)와 통합하면 사용자가 SAML 싱글 사인온을 사용하여 인증할 수 있습니다. 싱글 사인온(SSO)을 사용하면 airfocus 팀 관리자가 기존 IdP 솔루션을 통해 airfocus에 액세스할 수 있는 사용자를 지정할 수 있습니다. 팀 구성원들은 조직의 IdP에 로그인되어 있는 한 airfocus에 원활하게 액세스할 수 있습니다.

SAML 설정

미리 구축된 IdP 앱 사용하기

airfocus와의 SAML 통합을 위한 다음과 같은 사전 구축된 앱을 제공합니다.

수동 설정 안내

다른 IdP와의 연결을 수동으로 설정하고 싶다면, 다음 지침을 참고하여 시작할 수 있습니다:

  1. 새 서비스 공급자(SP) 생성:
    • SP 싱글 사인온 URL: https://auth.airfocus.com/login/sso/callback/saml
      • URL에서 "airfocus.com"을 "airfocus.app"으로 바꾸세요. 미국 또는 APAC 지역에 거주하시고 계정이 2025년 9월 이후에 생성된 경우에는 해당됩니다.
    • SP 엔티티 ID: https://airfocus.com
      • URL에서 "airfocus.com"을 "airfocus.app"으로 바꾸세요. 미국 또는 APAC 지역에 거주하시고 계정이 2025년 9월 이후에 생성된 경우에는 해당됩니다.
  2. SAML IdP를 구성하여 다음 속성 클레임을 제공합니다:

    부동산 청구 이름
    사용자 이메일 urn:oid:1.2.840.113549.1.9.1
    이메일(대안)
    사용자 전체 이름 urn:oid:2.16.840.1.113730.3.1.241
    displayName(대체 이름)
    사용자 이름 urn:oid:2.5.4.42
    givenName (대안)
    사용자 성 urn:oid:2.5.4.4
    성씨 (대체 성)
    사용자 역할 역할(아래의 "역할 프로비저닝" 참조)
  3. 귀하의 IdP의 구성을 확인하세요:
    • IdP 싱글 사인온 URL
    • IdP 발급자
    • IdP 서명 인증서
  4. airfocus에 로그인하세요.
    • 미국 또는 아시아 태평양 지역에 거주하고 2025년 9월 이후에 계정을 생성한 경우 airfocus.app을 사용하여 로그인하십시오. 그렇지 않으면 airfocus.com을 이용하세요.
  5. 왼쪽 하단에 있는 '팀 설정'을 클릭하세요.
  6. 보안/SSO 탭을 선택하세요.
  7. 위의 단계에서 복사해 붙여넣기를 하여 값을 구성하세요.
    set-up-okta-scim-saml-and-sso-1.png

역할 프로비저닝

IdP(ID 공급자)가 속성 클레임 role 제공하는 경우, 사용자가 SSO를 통해 로그인할 때마다 airfocus 에서 해당 역할이 할당됩니다. 다음 값들이 지원됩니다:

  • 관리자: 사용자에게 관리자 역할이 할당됩니다.
  • 에디터: 사용자에게 에디터 역할이 할당됩니다.
  • 기여자: 사용자에게 기여자 역할이 할당됩니다.

참고: 이는 SSO를 통한 새 로그인이 있을 때만 발생합니다. 일반 사용자 이름과 비밀번호 로그인으로는 이 문제가 발생하지 않습니다. 사용자가 SAML을 사용하여 로그인 버튼을 성공적으로 클릭할 때마다 역할이 동기화됩니다(즉, airfocus에 업데이트됩니다).

이 문서에 관한 피드백 공유

이 문서와 관련해 공유하고 싶은 피드백이 있으신가요? 여기에서 사용 경험을 말씀해 주세요.

원하는 정보를 찾으셨나요?

아직 궁금한 점이 남아 있거나 지식을 공유하고 싶으신가요? 커뮤니티 에서 멤버들의 도움을 받고 지식을 나눠보세요.