이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다:

• Chat Azure OpenAI
• Embeddings Azure OpenAI

사전 요구사항#

• Azure 구독을 생성하세요.
• 해당 구독 내에서 Azure OpenAI에 대한 액세스 권한이 필요합니다. 조직에서 아직 액세스 권한을 보유하고 있지 않다면 액세스를 요청해야 할 수 있습니다.

지원되는 인증 방법#

• API 키
• Azure Entra ID(OAuth2)

관련 자료#

서비스에 대한 자세한 내용은 Azure OpenAI API 문서를 참조하세요.

API 키 사용#

이 자격 증명을 구성하려면 다음이 필요합니다:

• Resource Name: 리소스에 부여한 Name입니다.
• API key: Key 1을 사용하면 됩니다. 이는 배포 전에 Keys and Endpoint에서 확인할 수 있습니다.
• 자격 증명이 사용할 API Version입니다. Azure OpenAI의 API 버전 관리에 대한 자세한 내용은 Azure OpenAI API 프리뷰 수명 주기 문서를 참조하세요.

위 정보를 얻으려면 Azure OpenAI Service 리소스를 생성하고 배포하세요.

Azure Entra ID (OAuth2) 사용#

셀프 호스팅 사용자의 경우, 처음부터 OAuth2를 구성하려면 크게 두 가지 단계를 거쳐야 합니다:

1. Microsoft Identity Platform에 애플리케이션 등록
2. 해당 애플리케이션에 대한 클라이언트 시크릿 생성

아래에서 각 단계에 대한 자세한 지침을 따르세요. Microsoft OAuth2 웹 플로에 대한 자세한 내용은 Microsoft 인증 및 인가 기본 사항을 참조하세요.

애플리케이션 등록#

Microsoft Identity Platform에 애플리케이션을 등록합니다:

1. Microsoft Application Registration Portal을 엽니다.
2. Register an application을 선택합니다.
3. 앱의 Name을 입력합니다.
4. Supported account types에서 **Accounts in any organizational directory (Any Azure AD directory - Multi-tenant) and personal Microsoft accounts (for example, Skype, Xbox)**를 선택합니다.
5. Register an application에서:
   1. n8n 자격 증명에서 OAuth Callback URL을 복사합니다.
   2. 이를 Redirect URI (optional) 필드에 붙여넣습니다.
   3. Select a platform > Web을 선택합니다.
6. Register를 선택하여 애플리케이션 생성을 완료합니다.
7. Application (client) ID를 복사하여 n8n의 Client ID로 붙여넣습니다.

자세한 내용은 Microsoft Identity Platform에 애플리케이션 등록을 참조하세요.

클라이언트 시크릿 생성#

애플리케이션을 생성한 후, 이에 대한 클라이언트 시크릿을 생성합니다:

1. Microsoft 애플리케이션 페이지에서 왼쪽 탐색 메뉴의 Certificates & secrets를 선택합니다.
2. Client secrets에서 + New client secret을 선택합니다.
3. 클라이언트 시크릿에 대한 Description을 입력합니다(예: n8n credential).
4. Add를 선택합니다.
5. Value 열에 있는 Secret을 복사합니다.
6. 이를 n8n의 Client Secret으로 붙여넣습니다.
7. n8n에서 Connect my account를 선택하여 연결 설정을 마칩니다.
8. Microsoft 계정에 로그인하고 앱이 사용자 정보에 액세스하도록 허용합니다.

클라이언트 시크릿 추가에 대한 자세한 내용은 Microsoft의 Add credentials를 참조하세요.

사용자 지정 스코프 설정#

Azure Entra ID 자격 증명은 기본적으로 다음 스코프를 사용합니다:

• openid
• offline_access
• AccessReview.ReadWrite.All
• Directory.ReadWrite.All
• NetworkAccessPolicy.ReadWrite.All
• DelegatedAdminRelationship.ReadWrite.All
• EntitlementManagement.ReadWrite.All
• User.ReadWrite.All
• Directory.AccessAsUser.All
• Sites.FullControl.All
• GroupMember.ReadWrite.All

다른 스코프를 자격 증명에 선택하려면 Custom Scopes 슬라이더를 활성화하고 Enabled Scopes 목록을 편집하세요. 스코프를 더 제한적으로 설정하면 일부 기능이 예상대로 작동하지 않을 수 있다는 점에 유의하세요.