다음을 통해 공유

SharePoint 서버 기반 통합을 위한 사용자 지정 클레임 정의

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

SharePoint를 사용한 서버 기반 통합의 경우 Microsoft Dynamics 365는 클레임을 사용하여 SharePoint에 저장된 문서에 액세스하는 Dynamics 365 사용자를 승인하고 인증합니다. 클레임 기반 인증에 대한 자세한 내용은 SharePoint 2013의 클레임 기반 ID를 참조하십시오.

기본적으로 Dynamics 365은 다음 클레임을 사용하여 SharePoint와 통합됩니다:

시나리오

손해 배상

Dynamics 365(온라인) 및 SharePoint Online

NameId (PUID)

Dynamics 365 및 SharePoint 모두 사용자 ID를 위해 Microsoft Azure Active Directory를 공유합니다.

Dynamics 365(온라인) 및 SharePoint 온-프레미스

SMTP (email)

사용자 ID에 대한 공유 활성 디렉터리 인프라가 없습니다. 클레임이 SMTP 주소로 전송되었습니다. 클레임이 Dynamics 365의 WindowsLiveID 필드에서 선택되고 SharePoint에서 전자 메일 주소를 사용하도록 매핑됩니다.

Dynamics 365 온-프레미스 및 SharePoint Online

SMTP (email)

사용자 ID에 대한 공유 활성 디렉터리 인프라가 없습니다. 클레임이 SMTP 주소로 전송되었습니다. 클레임이 Dynamics 365의 PrimaryEmailAddess 필드에서 선택되고 SharePoint에서 전자 메일 주소를 사용하도록 매핑됩니다.

Dynamics 365 온-프레미스 및 SharePoint 온-프레미스

Security Identifier (SID)

Dynamics 365 및 SharePoint는 사용자 ID를 위해 Microsoft Windows Server Active Directory를 공유합니다.

SharePoint에서 Dynamics 365 사용자를 승인하고 인증하기 위해 Dynamics 365에 의해 사용되는 기본값 이외의 값을 사용하기 위해 Dynamics 365에서 사용자 지정 클레임 매핑을 지정하는 데 UserMapping 엔터티를 사용할 수 있습니다. 예를 들어, SharePoint에서 Dynamics 365 사용자를 인증하기 위해 "전자 메일" 대신 사용자의 “성”과 “이름”을 사용할 수 있습니다. 사용자 지정 클레임 매핑은 Dynamics 365에서 사용되는 기본 클레임 매핑을 재정의합니다.Dynamics 365에서 사용자 지정 클레임 매핑을 여러 개 정의할 수 있습니다. 기본적으로 시스템 관리자 역할을 가진 사용자만 UserMapping 엔터티에 액세스할 수 있습니다.

Dynamics 365에서 사용자 지정 클레임 매핑을 정의하려면 UserMapping 엔터티 레코드를 만들고 다음 표에 나열된 특성 값을 지정합니다.

특성

값

설명

UserMapping.PartnerApplicationType

  • 0: SharePoint

  • 1: 내부 전용입니다.

이 클레임 매핑이 사용되는 파트너 응용 프로그램 유형입니다. 현재 버전에서는 0(SharePoint)만 지원됩니다.

UserMapping.SystemUserAttributeName

문자열 값

클레임의 값이 사용될 SystemUser(사용자) 엔터티에 있는 특성의 논리적 이름입니다.

참고

사용자 지정 클레임 매핑에 사용되는 특성에 값이 포함되지 않은 경우 기본 클레임 매핑은 Dynamics 365에서 사용됩니다. 예를 들어, 사용자 지정 클레임 매핑의 특성으로 사용자의 이름을 사용하기로 선택했는데 이름이 누락된 경우 Dynamics 365는 기본 클레임 매핑(PUID 또는 전자 메일)을 사용합니다.

UserMapping.ClaimType

문자열 값

SharePoint에 보낼 클레임 유형을 지정합니다. 클레임 유형 목록을 보려면 ClaimTypes 멤버를 참조하십시오.

참고

참조된 클레임 유형 목록은 참조용입니다. 나열된 모든 클레임 유형이 SharePoint에 의해 지원되지 않거나 SharePoint에서 지원되는 모든 클레임 유형을 포함하지 않을 수 있습니다.

다음 예제 코드는 UserMapping 엔터티를 사용하는 사용자 지정 클레임 매핑을 정의하는 방법을 보여줍니다.

UserMapping customMapping = new UserMapping
{
   PartnerApplicationType = new OptionSetValue(0),
   SystemUserAttributeName = "personalemailaddress",
   ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);

참고

유효한 값이 있는 UserMapping 엔터티의 인스턴스는 Dynamics 365에서 사용하는 기본 클레임 매핑을 재정의합니다.

기본적으로 SharePoint는 NameId(PUID), SMTP(전자 메일) 및 UPN(사용자 계정 이름)의 클레임 유형을 지원합니다. 다른 유형의 클레임을 전달하는 경우 SharePoint에서 해당 클레임 유형 매핑도 만들어야 합니다.추가 정보:New-SPClaimTypeMapping

참고 항목

UserMapping 엔터티 메시지 및 메서드
SharePoint와 Microsoft Dynamics 365 통합

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보