Configurazione di un provider di autenticazione Microsoft® Access Control Service
È possibile utilizzare Microsoft Access Control Service come provider di autenticazione con il protocollo OAuth. L'autorizzazione in genere viene gestita da un servizio Microsoft Office 365 come SharePoint® Online. L'autenticazione SSO da un provider di autenticazione Microsoft non è supportata.
Versioni (Edition) richieste
| Disponibile in: Lightning Experience e Salesforce Classic |
| Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition |
| Autorizzazioni utente richieste | |
|---|---|
| Per visualizzare le impostazioni: | Visualizza impostazione e configurazione |
| Per modificare le impostazioni: | Personalizza applicazione E Gestisci provider di autenticazione |
Per configurare un provider di autenticazione Microsoft Access Control Service, eseguire le seguenti operazioni.
- Definire un provider di autenticazione Microsoft Access Control Service in Salesforce.
- Registrare l'applicazione su Microsoft, impostando Salesforce come dominio dell'applicazione.
- Modificare i dettagli del provider di autenticazione Microsoft Access Control Service in Salesforce per utilizzare la chiave consumatore e il segreto consumatore generati quando l'applicazione è stata registrata su Microsoft.
- Provare la connessione.
Definizione di un provider di autenticazione Microsoft Access Control Service in Salesforce.
Per poter registrare un'applicazione in SharePoint Online o nel Microsoft Seller Dashboard, è necessario l'URL di richiamata che sarà utilizzato per reindirizzare l'utente autorizzato a Salesforce.
- Da Imposta, utilizzare la casella Ricerca veloce per trovare e selezionare Provider di autenticazione.
- Fai clic su Nuova.
- Selezionare Microsoft Access Control Service come tipo di provider.
- Immettere un nome per il provider.
- Immettere il Suffisso URL utilizzato negli URL della configurazione client. Ad esempio, se il suffisso URL del provider è MyMicrosoftACSProvider, l'URL SSO sarà simile a https://mydomain_url or site_url /services/auth/sso/MicrosoftACSProvider.
- Per Chiave consumatore, immettere un valore segnaposto. Questo valore si modificherà quando l'applicazione sarà registrata su Microsoft.
- Per Segreto consumatore, immettere un valore segnaposto. Questo valore si modificherà quando l'applicazione sarà registrata su Microsoft.
- Per Autorizza URL endpoint, immettere l'URL base del provider per il campo Autorizza URL endpoint. Ad esempio, SharePoint Online utilizza questo formato: https://<sharepoint online host name>/_layouts/15/OAuthAuthorize.aspx
-
Per URL endpoint token, immettere l'URL nel formato seguente: https://accounts.accesscontrol.windows.net/<tenant>/tokens/OAuth/2?resource=<sender ID>/<sharepoint online host name>@<tenant>
- <tenant> è il nome tenant di Office 365 che termina con .onmicrosoft.com o il GUID (Globally Unique Identifier) del tenant corrispondente.
- <sender ID> è l'identificatore del mittente del token. Ad esempio, SharePoint utilizza
00000003-0000-0ff1-ce00-000000000000.
-
Eventualmente, impostare questi campi:
- Per Ambiti predefiniti, immettere gli ambiti da inviare insieme alla richiesta all'endpoint di autorizzazione. Per ulteriori informazioni sugli ambiti per SharePoint Online, vedere http://msdn.microsoft.com/en-us/library/jj687470.aspx#Scope. Per ulteriori informazioni sull'utilizzo degli ambiti con Salesforce, vedere Personalizzazione delle richieste di dati.
- Se si immettono una chiave consumatore e un segreto consumatore, il segreto consumatore viene incluso nelle risposte dell'API SOAP per impostazione predefinita. Per nascondere il segreto nelle risposte API SOAP, deselezionare Includi segreto consumatore nelle risposte API SOAP. A partire da novembre 2022, nelle risposte dell'API dei metadati il segreto viene sempre sostituito con un valore segnaposto. Alla distribuzione, sostituire il segnaposto con il segreto consumatore come testo normale o modificare il valore successivamente tramite l'interfaccia utente.
- Per URL di errore personalizzato, immettere l'URL utilizzato dal provider per segnalare eventuali errori.
- Per URL di disconnessione personalizzato, immettere un URL per indicare una destinazione specifica per gli utenti autenticati con il flusso SSO che si disconnettono. Usare questo campo per indirizzare gli utenti a una pagina di disconnessione con l'immagine aziendale o a una destinazione diversa dalla pagina di disconnessione predefinita di Salesforce. L'URL deve essere completo e dotato di prefisso http o https, ad esempio https://acme.my.salesforce.com.
configurare il Single Logout (SLO) per disconnettere automaticamente un utente da Salesforce e dal provider di identità. In qualità di relying party, Salesforce supporta SLO OpenID Connect quando l'utente si disconnette dal provider di identità o da Salesforce.
- Per utilizzare un portale con il provider, selezionare il portale dall'elenco a discesa Portale. Se è impostato un portale, questa opzione può reindirizzare la richiesta di accesso alla pagina di accesso del portale. In caso contrario, lasciare il campo impostato su Nessuno.
- Per URL icona, aggiungere un percorso a un'icona da visualizzare come pulsante nella pagina di accesso di un sito. Questa icona è valida solo per un sito Experience Cloud Non compare nella pagina di accesso di Salesforce né nell'URL di accesso di Dominio personale. Gli utenti fanno clic sul pulsante per accedere con il provider di autenticazione associato del sito.
Specificare il percorso di un'immagine a scelta, oppure copiare nel campo l'URL di una delle icone di esempio.
- Per utilizzare la funzionalità di autenticazione a più fattori (MFA) di Salesforce anziché il servizio MFA del provider di identità, selezionare Usa autenticazione a più fattori (MFA) Salesforce per questo provider SSO. Questa impostazione attiva la MFA solo per gli utenti per cui la MFA è stata applicata direttamente. Per ulteriori informazioni, vedere Utilizzo della MFA Salesforce per SSO (organizzazioni Salesforce).
- Salvare il proprio lavoro.
Prendere nota del valore ID provider di autenticazione generato. Può essere usato con la classe Auth.AuthToken Apex.
Dopo la definizione del provider di autenticazione vengono generati alcuni URL di configurazione client.
- URL inizializzazione solo test — Gli amministratori usano questo URL per assicurarsi che il provider esterno sia impostato correttamente. L'amministratore apre l'URL in un browser, accede al provider esterno e viene reindirizzato a Salesforce con una mappa di attributi.
- URL di inizializzazione solo OAuth — Utilizzare questo URL per ottenere token di accesso OAuth per terzi. Per consentire al servizio di terzi di ottenere un token, gli utenti devono autenticarsi in Salesforce. Questo flusso non è predisposto per una futura funzionalità di Single Sign-On.
- URL di richiamata — Utilizzare questo URL di richiamata come endpoint che il provider di autenticazione richiama per la configurazione. Il provider di autenticazione reindirizza all'URL di richiamata con le informazioni per ciascuno degli URL di configurazione client.
Gli URL di configurazione client supportano ulteriori parametri di richiesta che consentono di richiedere agli utenti di accedere a specifici siti, ottenere autorizzazioni personalizzate da terzi o passare a un percorso specifico dopo l'autenticazione.
Registrazione dell'applicazione su Microsoft
Prima di configurare un'applicazione per Salesforce è necessario ottenere un'identità per l'applicazione mediante una delle opzioni offerte da Microsoft. Per informazioni sulla registrazione di un'applicazione remota per SharePoint, vedere le linee guida per la registrazione delle applicazioni per SharePoint 2013.
- Registrare l'applicazione mediante una delle opzioni offerte da Microsoft.
- Modificare le impostazioni dell'applicazione e impostare l'URI di reindirizzamento sull'URL di richiamata del provider di autenticazione.
- Annotare l'ID client e il segreto client.
- Salvare il proprio lavoro.
Modifica dei dettagli del provider di autenticazione Microsoft Access Control Service
Dopo aver registrato l'app in Microsoft, tornare alla pagina dei dettagli del provider di autenticazione Microsoft Access Control Service. Aggiornare la chiave consumatore e il segreto consumatore con i valori forniti da Microsoft.
- Da Imposta, utilizzare la casella Ricerca veloce per trovare e selezionare Provider di autenticazione.
- Fare clic su Modifica accanto al nome del provider di autenticazione Microsoft Access Control Service.
- Per Chiave consumatore, immettere l'ID client Microsoft.
- Per Segreto consumatore, immettere il segreto client Microsoft.
Provare la connessione
In un browser, aprire l'URL inizializzazione solo test nella pagina di impostazione del provider di autenticazione. Si viene reindirizzati a Microsoft. Viene chiesto di eseguire l'accesso e poi di autorizzare l'applicazione. Dopo avere concesso l'autorizzazione si è nuovamente indirizzati a Salesforce.
