URL identità
L'URL identità consente di accedere al servizio Salesforce Identity utilizzando i flussi utente-agente OAuth 2.0 o server Web OAuth 2.0. In questi flussi, quando un'applicazione connessa con ambito id viene autorizzata correttamente, riceve un URL identità insieme al token di accesso. L'applicazione connessa può quindi inviare una richiesta GET con il token di accesso all'URL identità. In risposta Salesforce restituisce i dettagli relativi all'utente e all'organizzazione sottoposti a query.
Versioni (Edition) richieste
| Disponibile in: Salesforce Classic e Lightning Experience |
| Disponibile in: tutte le versioni |
L'URL identità viene restituito nel parametro scope id. Ad esempio, https://login.salesforce.com/id/00Dx0000000BV7z/005x00000012Q9P.
L'URL identità è anche un'API RESTful utilizzata per chiedere ulteriori informazioni sugli utenti, ad esempio nome utente, indirizzo email e ID organizzazione. Restituisce anche gli endpoint con cui il client può comunicare, quali fotografie per i profili ed endpoint dell'API accessibili.
Accesso del client
L'accesso del client all'URL identità per un utente non consente l'accesso all'URL identità di un altro utente della stessa organizzazione a meno che il token associato non soddisfi tutte queste condizioni.
- La richiesta OAuth per il token di accesso include l'ambito
fulloapi. - Il token di accesso è per un utente che dispone dell'autorizzazione API abilitata.
- Il token di accesso è per un utente che ha accesso all'altro utente in base alle regole di condivisione utenti dell'organizzazione.
- Il token di accesso è per un utente interno, ovvero il valore user_type nella risposta è
STANDARD.
In caso contrario, viene richiesto il token di accesso di ciascun utente per visualizzare l'URL identità dell'utente.
Il formato dell'URL è https://login.salesforce.com/id/orgID/userID, dove orgId è l'ID dell'organizzazione Salesforce a cui appartiene l'utente e userID è l'ID dell'utente Salesforce.
Parametri della richiesta di URL identità
Con il token di accesso e l'URL identità si possono utilizzare i seguenti parametri. È possibile utilizzare il token di accesso nell'intestazione di una richiesta di autorizzazione o in una richiesta con il parametro oauth_token.
Risposta URL identità
Se la richiesta ha esito positivo, la risposta URL identità restituisce informazioni sull'utente e sull'organizzazione sottoposti a query.
La seguente risposta URL identità è in formato XML.
<?xml version="1.0" encoding="UTF-8"?>
<user xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<id>https://MyDomainName.my.salesforce.com/id/00Dx000.../005x000...</id>
<asserted_user>true</asserted_user>
<user_id>005x000000...</user_id>
<organization_id>00Dx000...</organization_id>
<nick_name>admin1.2777578168398293E12...</nick_name>
<display_name>Alan Van</display_name>
<email>admin@mycompany.com</email>
<status>
<created_date xsi:nil="true"/>
<body xsi:nil="true"/>
</status>
<photos>
<picture>https://MyDomainName--03925205UAF.file.force-user-content.com</picture>
<thumbnail>https://MyDomainName--03925205UAF.file.force-user-content.com</thumbnail>
</photos>
<urls>
<enterprise>https://MyDomainName.my.salesforce.com/services/Soap/c/{version}/00Dx000...</enterprise>
<metadata>https://MyDomainName.my.salesforce.com/services/Soap/m/{version}/00Dx000...</metadata>
<partner>https://MyDomainName.my.salesforce.com/services/Soap/u/{version}/00Dx000...</partner>
<rest>https://MyDomainName.my.salesforce.com/services/data/v{version}/
</rest>
<sobjects>https://MyDomainName.my.salesforce.com/services/data/v{version}/sobjects/
</sobjects>
<search>https://MyDomainName.my.salesforce.com/services/data/v{version}/search/
</search>
<query>https://MyDomainName.my.salesforce.com/services/data/v{version}/query/
</query>
<profile>https://MyDomainName.my.salesforce.com/005x000...</profile>
</urls>
<active>true</active>
<user_type>STANDARD</user_type>
<language>en_US</language>
<locale>en_US</locale>
<utcOffset>-28800000</utcOffset>
<last_modified_date>2021-04-28T20:54:09.000Z</last_modified_date>
</user>E questa risposta è in formato JSON.
{"id":"https://MyDomainName.my.salesforce.com/id/00Dx000.../005x000...",
"asserted_user":true,
"user_id":"005x000...",
"organization_id":"00Dx000...",
"nick_name":"admin1.2777578168398293E12...",
"display_name":"Alan Van",
"email":"admin@mycompany.com",
"status":{"created_date":null,"body":null},
"photos":{"picture":"https://MyDomainName--03925205UAF.file.force-user-content.com",
"thumbnail":"https://MyDomainName--03925205UAF.file.force-user-content.com"},
"urls":
{"enterprise":"https://MyDomainName.my.salesforce.com/services/Soap/c/{version}/00Dx000...",
"metadata":"https://MyDomainName.my.salesforce.com/services/Soap/m/{version}/00Dx000...",
"partner":"https://MyDomainName.my.salesforce.com/services/Soap/u/{version}/00Dx000...",
"rest":"https://MyDomainName.my.salesforce.com/services/data/v{version}/",
"sobjects":"https://MyDomainName.my.salesforce.com/services/data/v{version}/sobjects/",
"search":"https://MyDomainName.my.salesforce.com/services/data/v{version}/search/",
"query":"https://MyDomainName.my.salesforce.com/services/data/v{version}/query/",
"profile":"https://MyDomainName.my.salesforce.com/005x000..."},
"active":true,
"user_type":"STANDARD",
"language":"en_US",
"locale":"en_US",
"utcOffset":-28800000,
"last_modified_date":"2021-04-28T20:54:09.000+0000"}Nella tabella seguente sono descritti i parametri restituiti.
| Parametro | Descrizione |
|---|---|
id
|
URL identità ovvero lo stesso URL sottoposto a query. |
asserted_user
|
Valore booleano che indica se il token di accesso specificato è stato emesso per questa identità |
user_id
|
ID utente dell'utente sottoposto a query. |
username
|
Nome utente dell'utente sottoposto a query. |
organization_id
|
ID dell'organizzazione Salesforce dell'utente sottoposto a query. |
nick_name
|
Nickname Experience Cloud dell'utente sottoposto a query. |
display_name
|
Il nome visualizzato (nome completo) dell'utente sottoposto a query. |
email
|
Indirizzo email dell'utente sottoposto a query. |
email_verified
|
Indica se l'email dell'utente sottoposto a query è stata verificata facendo clic su un link nel messaggio di benvenuto in Salesforce. Il valore email_verified viene impostato su
|
first_name
|
Nome dell'utente sottoposto a query. |
last_name
|
Cognome dell'utente sottoposto a query. |
timezone
|
Il fuso orario specificato nelle impostazioni dell'utente |
photos
|
Mappa degli URL alle immagini del profilo dell'utente sottoposto a query, specificate come Nota l'accesso a questi URL richiede la trasmissione di un token di accesso. Vedere i token di accesso. |
addr_street
|
La via specificata nell'indirizzo delle impostazioni dell'utente sottoposto a query. |
addr_city
|
La città specificata nell'indirizzo delle impostazioni dell'utente sottoposto a query. |
addr_state
|
Lo stato specificato nell'indirizzo delle impostazioni dell'utente sottoposto a query. |
addr_country
|
Il paese specificato nell'indirizzo delle impostazioni dell'utente sottoposto a query. |
addr_zip
|
Il codice postale specificato nell'indirizzo delle impostazioni dell'utente sottoposto a query. |
mobile_phone
|
Il numero di cellulare specificato nelle impostazioni dell'utente sottoposto a query. |
mobile_phone_verified
|
L'utente sottoposto a query ha confermato che il numero di cellulare è valido. |
status
|
Stato Chatter corrente dell'utente sottoposto a query.
|
urls
|
Mappa contenente diversi endpoint API che possono essere utilizzati con l'utente sottoposto a query Nota l'accesso agli endpoint REST richiede la trasmissione di un token di accesso. Vedere i token di accesso.
|
active
|
Valore booleano che specifica se l'utente sottoposto a query è attivo. |
user_type
|
Tipo dell'utente sottoposto a query. |
language
|
Lingua dell'utente sottoposto a query. |
locale
|
Impostazioni internazionali dell'utente sottoposto a query. |
utcOffset
|
Differenza rispetto al fuso UTC del fuso orario dell'utente sottoposto a query, in millisecondi. |
last_modified_date
|
Formato di xsd datetime dell'ultima modifica dell'utente, ad esempio 2010-06-28T20:54:09.000Z. |
is_app_installed
|
Il valore è true quando l'applicazione connessa viene installata nell'organizzazione dell'utente e il token di accesso dell'utente è stato creato utilizzando un flusso OAuth. Se l'applicazione connessa non è installata, la risposta non contiene questo valore. Quando si analizza la risposta, verificare sia l'esistenza che il valore di questa proprietà. |
mobile_policy
|
Valori specifici per la gestione delle applicazioni connesse mobili. Questi valori sono disponibili solo quando l'applicazione connessa è installata nell'organizzazione dell'utente corrente e l'applicazione ha un valore di timeout della sessione definito e il valore della lunghezza del PIN mobile è definita.
|
push_service_type
|
Impostare su Il tipo di valore della risposta è una matrice. |
custom_permissions
|
Quando una richiesta include il parametro scope Di seguito è riportato un esempio di richiesta. Di seguito è riportato il blocco JSON nella risposta URL identità. |
Errori potenziali
Quando viene eseguita una richiesta non valida, Salesforce può inviare i seguenti errori nelle risposte.
| Codice errore | Problema richiesta |
|---|---|
| 403 (forbidden) — HTTPS_Required | HTTP |
| 403 (forbidden) — Missing_OAuth_Token | Token di accesso mancante |
| 403 (forbidden) — Bad_OAuth_Token | Token di accesso non valido |
| 403 (forbidden) — Wrong_Org | Utente in un'organizzazione diversa |
| 404 (not found) — Bad_Id | ID organizzazione o utente non valido o errato |
| 404 (not found) — Inactive | Utente disattivato o organizzazione inattiva |
| 404 (not found) — No_Access | Utente sprovvisto di accesso adeguato all'organizzazione o alle informazioni |
| 404 (not found) — No_Site_Endpoint | Richiesta a un endpoint non valido di un sito |
| 404 (not found) — Internal Error | Nessuna risposta dal server |
| 406 (not acceptable) — Invalid_Version | Versione non valida |
| 406 (not acceptable) — Invalid_Callback | Richiamata non valida |

