Azure OpenAI 자격 증명
다음 node를 인증하는 데 이 자격 증명을 사용할 수 있습니다: 서비스에 대한 자세한 내용은 Azure OpenAI API 문서를 참조하세요. 이 자격 증명을 구성하려면 다음이 필요합니다: 위 정보를 얻으려면 Azure OpenAI Service 리소스를 생성하고 배포합니다.
다음 node를 인증하는 데 이 자격 증명을 사용할 수 있습니다:
사전 요구 사항#
지원되는 인증 방법#
- 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 OpenAI node의 모델 이름으로 Deployment name을 사용하세요.
Azure Entra ID (OAuth2) 사용#
Cloud 사용자는 연결 정보를 제공할 필요가 없습니다. **내 계정 연결(Connect my account)**을 선택하여 브라우저를 통해 연결하세요.
셀프 호스팅 사용자의 경우 OAuth2를 처음부터 구성하는 두 가지 주요 단계가 있습니다:
- Microsoft Identity Platform에 애플리케이션 등록.
- 해당 애플리케이션에 대한 클라이언트 시크릿 생성.
각 단계에 대한 자세한 지침은 아래를 참조하세요. Microsoft OAuth2 웹 플로우에 대한 자세한 내용은 Microsoft 인증 및 권한 부여 기본 사항을 참조하세요.
애플리케이션 등록#
Microsoft Identity Platform에 애플리케이션을 등록합니다:
- Microsoft 애플리케이션 등록 포털을 엽니다.
- Register an application을 선택합니다.
- 앱의 Name을 입력합니다.
- Supported account types에서 **Accounts in any organizational directory (Any Azure AD directory - Multi-tenant) and personal Microsoft accounts (for example, Skype, Xbox)**를 선택합니다.
- Register an application에서:
- n8n 자격 증명에서 OAuth Callback URL을 복사합니다.
- Redirect URI (optional) 필드에 붙여넣습니다.
- Select a platform > Web을 선택합니다.
- Register를 선택하여 애플리케이션 생성을 완료합니다.
- Application (client) ID를 복사하여 n8n에 Client ID로 붙여넣습니다.
자세한 내용은 Microsoft Identity Platform에 애플리케이션 등록을 참조하세요.
클라이언트 시크릿 생성#
애플리케이션을 생성한 후 클라이언트 시크릿을 생성합니다:
- Microsoft 애플리케이션 페이지에서 왼쪽 네비게이션의 Certificates & secrets를 선택합니다.
- Client secrets에서 + New client secret을 선택합니다.
n8n credential과 같은 클라이언트 시크릿의 Description을 입력합니다.- Add를 선택합니다.
- Value 열에서 Secret을 복사합니다.
- n8n에 Client Secret으로 붙여넣습니다.
- n8n에서 Connect my account를 선택하여 연결 설정을 완료합니다.
- Microsoft 계정에 로그인하고 앱이 정보에 접근하도록 허용합니다.
클라이언트 시크릿 추가에 대한 자세한 내용은 Microsoft의 자격 증명 추가를 참조하세요.
사용자 정의 스코프 설정#
Azure Entra ID 자격 증명은 기본적으로 다음 스코프를 사용합니다:
openidoffline_accessAccessReview.ReadWrite.AllDirectory.ReadWrite.AllNetworkAccessPolicy.ReadWrite.AllDelegatedAdminRelationship.ReadWrite.AllEntitlementManagement.ReadWrite.AllUser.ReadWrite.AllDirectory.AccessAsUser.AllSites.FullControl.AllGroupMember.ReadWrite.All
자격 증명에 다른 스코프를 선택하려면 Custom Scopes 슬라이더를 활성화하고 Enabled Scopes 목록을 편집합니다. 더 제한적인 스코프를 사용하면 일부 기능이 예상대로 작동하지 않을 수 있음을 유의하세요.
