Definire il mapping attestazioni personalizzato per l'integrazione di SharePoint basata su server
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Per l'integrazione basata su server di SharePoint, Microsoft Dynamics 365 utilizza le attestazioni per autenticare e autorizzare gli utenti di Dynamics 365 per l'accesso ai documenti archiviati in SharePoint. Per ulteriori informazioni sull'autenticazione basata sulle attestazioni, vedi Identità basata sulle attestazioni in SharePoint 2013.
Per impostazione predefinita, Dynamics 365 utilizza le seguenti attestazioni per l'integrazione con SharePoint:
Scenario |
Richieste di indennizzo |
|---|---|
Dynamics 365 (online) e SharePoint Online |
NameId (PUID) Sia Dynamics 365 che SharePoint condividono Microsoft Azure Active Directory per l'identità utente. |
Dynamics 365 (online) e SharePoint locale |
SMTP (email) Nessuna infrastruttura condivisa di Active Directory per l'identità utente; attestazioni inviate come indirizzo SMTP. Le attestazioni vengono selezionate dal campo WindowsLiveID in Dynamics 365 e mappate all'indirizzo di posta elettronica di lavoro da SharePoint. |
Dynamics 365 locale e SharePoint Online |
SMTP (email) Nessuna infrastruttura condivisa di Active Directory per l'identità utente; attestazioni inviate come indirizzo SMTP. Le attestazioni vengono selezionate dal campo PrimaryEmailAddess in Dynamics 365 e mappate all'indirizzo di posta elettronica di lavoro da SharePoint. |
Dynamics 365 locale e SharePoint locale |
Security Identifier (SID) Sia Dynamics 365 che SharePoint condividono Active Directory di Microsoft Windows Server per l'identità utente. |
Puoi utilizzare l'entità UserMapping per specificare i mapping di attestazione personalizzati in Dynamics 365 per utilizzare un valore diverso da quello predefinito utilizzato da Dynamics 365 per autenticare e autorizzare gli utenti di Dynamics 365 in SharePoint. Ad esempio, puoi utilizzare il cognome e il nome dell'utente anziché l'indirizzo e-mail per autenticare gli utenti di Dynamics 365 in SharePoint. I mapping di attestazioni personalizzati sovrascrivono i mapping di attestazione predefiniti utilizzati da Dynamics 365. Puoi definire più mapping di attestazione personalizzati in Dynamics 365. Per impostazione predefinita, solo gli utenti con il ruolo di amministratore di sistema dispongono dell'accesso all'entità UserMapping.
Per definire un mapping di attestazione personalizzato in Dynamics 365, crea un record di entità UserMapping e specifica i valori degli attributi elencati nella tabella seguente.
Attributo |
Valore |
Descrizione |
|---|---|---|
UserMapping.PartnerApplicationType |
|
Tipo di applicazione partner per cui il mapping di attestazione deve essere usato. Nella versione corrente, solo 0 (SharePoint) è supportato. |
UserMapping.SystemUserAttributeName |
Valore Stringa |
Nome logico dell'attributo dell'entità SystemUser (utente) da cui verrà utilizzato il valore per le attestazioni. Nota Se l'attributo utilizzato per il mapping di attestazione personalizzato non contiene alcun valore, il mapping di attestazione predefinito viene utilizzato da Dynamics 365. Ad esempio, se vuoi utilizzare il nome dell'utente come attributo per il mapping di attestazione personalizzato e il nome dell'utente non è presente, Dynamics 365 utilizzerà il mapping di attestazione predefinito (PUID o indirizzo e-mail). |
UserMapping.ClaimType |
Valore Stringa |
Specificare il tipo di attestazione da inviare a SharePoint. Per un elenco dei tipi di attestazione, vedi Membri ClaimTypes. Nota L'elenco di tipi di attestazioni a cui si fa riferimento è solo per riferimento. Tutti i tipi di attestazione elencati potrebbero non essere supportati da SharePoint oppure potrebbero non contenere tutti i tipi di attestazione supportati da SharePoint. |
Il seguente codice di esempio illustra come definire un mapping di attestazione personalizzato utilizzando l'entità UserMapping.
UserMapping customMapping = new UserMapping
{
PartnerApplicationType = new OptionSetValue(0),
SystemUserAttributeName = "personalemailaddress",
ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);
Nota
Ogni istanza dell'entità UserMapping con valori validi sostituirà i mapping di attestazione predefiniti utilizzato da Dynamics 365.
Per impostazione predefinita, SharePoint supporta i seguenti tipi di attestazione: NameId (PUID), SMTP (indirizzo e-mail) e UPN (nome dell'entità utente). Se utilizzi un'attestazione di tipo diverso, devi anche creare i mapping del tipo di attestazione corrispondenti in SharePoint.Ulteriori informazioni:New-SPClaimTypeMapping
Vedere anche
Metodi e messaggi dell'entità UserMapping
Integrare Microsoft Dynamics 365 con SharePoint
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright