Azure AD SAML 설정

n8n에서 Azure AD를 사용합니다.

이 문서는 SAML 속성을 통해 Azure AD가 역할 정보를 n8n으로 전송하도록 구성하는 방법을 설명합니다. 이를 통해 Azure AD 그룹 멤버십을 기반으로 자동 역할 할당이 가능합니다. 사전 요구 사항 # Enterprise Applications에 접근할 수 있는 Azure AD 계정과 n8n의 SAML 설정에서 얻은 리디렉션 URL 및 엔터티 ID가 필요합니다. 먼저 SAML 설정 가이드를 읽어보세요. n8n에 필요한 사항 # n8n은 SAML assertion에 사용자 지정 SAML 속성이 포함되기를 기대합니다. 속성 이름(Attribute Name) 데이터 유형(Data Type) 목적(Purpose) n8n_instance_role String n8n에서 사용자의 전역 역할을 제어합니다 n8n_instance_role 의 유효한 값: 값(Value) 설명(Description) global:owner 전체 인스턴스 소유자 접근 권한 global:admin 관리자 접근 권한 global:member 일반 멤버 접근 권한(지정하지 않은 경우 기본값) global:chatUser Chat Hub 인터페이스를 통해 AI 에이전트와 안전하게 상호작용하도록 설계된, n8n의 제한적이고 비기술적인 역할 설정 # 1단계: 표준 SAML 속성 구성 Azure AD 포털에서 n8n Enterprise Application으로 이동합니다. Single sign-on > Attributes & Claims 로 이동합니다. 다음 표준 속성이 구성되어 있는지 확인합니다. 클레임 이름(Claim Name) 원본 속성(Source Attribute) http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress user.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims/firstname user.givenname http://schemas.xmlsoap.org/ws/2005/05/identity/claims/lastname user.surname http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn user.userprincipalname 2단계: n8n_instance_role 클레임 추가 이 클레임은 조건부 로직을 사용하여 Azure AD 그룹 멤버십에 따라 서로 다른 역할 값을 내보냅니다. Attributes & Claims 에서 Add new claim 을 클릭합니다. 기본 설정을 구성합니다. Name : n8n_instance_role Namespace : 비워 둡니다 Source : Attribute Claim conditions 를 펼치고 Add condition 을 클릭합니다. 각 Azure AD 그룹에 대해 조건을 추가합니다(우선순위 순서로). 사용자 유형(User Type) 범위 지정 그룹(Scoped Groups) 원본(Source) 값(Value) M