Dynamics 365 설정 가이드

이 가이드에서는 BuiltWith가 Dynamics 365 인스턴스에 인증하고 리드를 자동으로 업데이트할 수 있도록 Azure AD 애플리케이션을 등록하는 방법을 안내합니다. Azure Active Directory 관리자 권한과 Dynamics 365 시스템 관리자 권한이 필요합니다.

1단계 - Azure Active Directory에 새 앱 등록

Azure 관리자 계정으로 portal.azure.com 에 로그인합니다. 왼쪽 메뉴에서 Azure Active Directory를 선택한 다음 앱 등록을 선택하고 + 새 등록을 클릭합니다.

BuiltWith Integration 과 같은 이름을 입력하세요. 지원되는 계정 유형에서 '이 조직 디렉터리의 계정만(단일 테넌트)'을 선택합니다. 리디렉션 URI는 비워두고 '등록'을 클릭합니다.

앱 개요 페이지에서 애플리케이션(클라이언트) ID 와 디렉터리(테넌트) ID를 복사하세요. BuiltWith에 자격 증명을 입력할 때 두 ID 모두 필요합니다.

2단계 - Dynamics 365용 API 권한 구성

앱 등록 시 왼쪽 메뉴에서 API 권한을 클릭한 다음 + 권한 추가를 클릭합니다. Dynamics CRM을 선택합니다(목록에 나타나지 않으면 "내 조직에서 사용하는 API"에서 검색). 위임된 권한을 선택하고 user_impersonation을 선택한 다음 권한 추가를 클릭합니다.

3단계 - 클라이언트 비밀 키 생성

앱 등록에서 '인증서 및 비밀'을 클릭하세요. '클라이언트 비밀' 아래에서 '+ 새 클라이언트 비밀' 을 클릭하고 '빌드 대상' 과 같은 설명을 입력한 다음 만료 기간을 선택하고 '추가'를 클릭하세요.

비밀 값 (값 열에 있는 긴 문자열이며, 비밀 ID가 아님)을 즉시 복사하세요. 이 값은 한 번만 표시되며 페이지를 벗어나면 숨겨집니다.

4단계 - 관리자 승인 부여

앱 등록의 API 권한 설정으로 돌아가서 '관리자 동의 부여'를 클릭하세요. '예' 를 클릭하여 확인하십시오. 동의가 승인되면 상태 열에 각 권한 옆에 녹색 체크 표시가 나타납니다.

5단계 - 앱을 Dynamics 365 애플리케이션 사용자로 추가합니다.

admin.powerplatform.microsoft.com 으로 이동하여 환경을 선택합니다. 설정 → 사용자 + 권한 → 응용 프로그램 사용자 로 이동한 다음 + 새 앱 사용자 추가를 클릭합니다.

[+ 앱 추가]를 클릭하고 앱 등록 이름(BuiltWith Integration)을 검색하여 선택합니다. 비즈니스 단위를 선택하고 [생성]을 클릭합니다.

새로 생성된 애플리케이션 사용자를 열고 영업 담당자 보안 역할 또는 리드 엔티티에 대한 읽기 및 쓰기 권한이 포함된 사용자 지정 역할을 할당합니다. 최소한 해당 역할에는 리드 엔티티에 대한 생성, 읽기, 쓰기, 추가 및 추가 권한이 있어야 합니다.

6단계 - BuiltWith에 자격 증명을 입력합니다.

BuiltWith Dynamics 365 연결 페이지로 돌아가서 다음 필드를 입력하십시오.

클라이언트 ID — 1단계에서 복사한 애플리케이션(클라이언트) ID입니다.
클라이언트 비밀 — 3단계에서 복사한 비밀 값(비밀 ID가 아님).
테넌트 ID — 1단계에서 복사한 디렉터리(테넌트) ID입니다.
Dynamics 365 URL — 사용자의 Dynamics 365 인스턴스 URL입니다(예: https://yourorg.crm.dynamics.com). 이 URL은 Power Platform 관리 센터의 환경 → 사용자 환경 → 환경 URL에서 찾을 수 있습니다.

저장을 클릭하세요. BuiltWith는 Dynamics 365 인스턴스에 테스트 호출을 실행하여 자격 증명을 확인합니다. 확인이 완료되면 리드 정보 보강이 자동으로 시작됩니다.

인증 오류가 발생하는 경우, 4단계에서 관리자 승인이 부여되었는지, 그리고 5단계에서 애플리케이션 사용자에게 올바른 보안 역할이 할당되었는지 확인하십시오.