Hoja de referencia de SCIM y API de REST
Para gestionar objetos de usuario de Salesforce con SCIM, puede enviar operaciones crear, leer, actualizar y desactivar (CRUD) de API de REST a extremos de o SCIM. Debe suministrar un token de acceso de OAuth 2.0 para realizar estas operaciones.
Ediciones necesarias
| Disponible en: Salesforce Classic y Lightning Experience |
| Disponible en: Todas las ediciones |
Para obtener ayuda con la configuración de sus operaciones de API de REST, consulte estas secciones.
Extremos de SCIM y operaciones de CRUD
Esta tabla enumera los extremos de SCIM y sus operaciones compatibles.
| Extremo de SCIM | Descripción | Operaciones compatibles |
|---|---|---|
| https://MyDomainName.my.salesforce.com/services/scim/v2/ServiceProviderConfigs | Solicite las funciones de la implementación de Salesforce SCIM. | Leer: GET |
| https://MyDomainName.my.salesforce.com/services/scim/v2/Schemas | Introspeccione recursos y extensiones de atributos | Leer: GET |
| https://MyDomainName.my.salesforce.com/services/scim/v2/ResourceTypes | Descubra los tipos de recursos disponibles, como usuarios y asignaciones. | Leer: GET |
| https://MyDomainName.my.salesforce.com/services/scim/v2/Entitlements | Visualice asignaciones de asistencia, como perfiles y conjuntos de permisos, asignados a usuarios. Al consultar todas las asignaciones en una organización, este extremo devuelve un máximo de 200 registros. Para ver más de 200 registros, consulte asignaciones específicas. |
Leer: GET |
| https://NombreMiDominio.my.salesforce.com/services/scim/v2/Roles | Visualice funciones asignadas a usuarios. | Leer: GET |
https://MyDomainName.my.salesforce.com /services/scim/v2/Users https://MyDomainName.my.salesforce.com/services/scim/v2/Users/<Id_Usuario> |
Proporcionar y gestionar objetos de usuario. | Crear: Leer: Actualizar: Desactivar: |
| https://MyDomainName.my.salesforce.com/services/scim/v2/Groups | Vea y gestione grupos públicos a los que pertenecen usuarios. | Leer: Actualizar: |
Reglas de operaciones
Al redactar operaciones SCIM, tenga en cuenta estas reglas.
- En una cláusula,
ANDno tiene prioridad sobreOR. Si una cláusula contiene tantoANDcomoOR, agregue de forma explícita corchetes a las cláusulas. - En una cláusula, los nombres de atributos y los operadores distinguen entre mayúsculas y minúsculas.
- Filtre estos campos a su manera.
- Usuarios: asignaciones, grupos
- Grupos: miembros
- Asignaciones: miembros
Extensiones de SCIM compatibles
Salesforce admite estas extensiones de usuario de Salesforce bajo la URN urn:salesforce:schemas:extension:2.0.
-
alias -
callCenterId -
extension
Nota En el contexto de esta URN, el campoextensiondescribe la extensión de teléfono del usuario, no una extensión de esquema SCIM.
Salesforce también admite estas extensiones de Usuario de compañía, que aparecen bajo la URN urn:scim:schemas:extension:enterprise:2.0.
-
organization -
employeeNumber -
department manager(managerIdydisplayName)delegatedApprover(delegatedApproverIdydisplayName)-
division
Salesforce también admite campos personalizados, que aparecen bajo la URN urn:salesforce:schemas:extension:18CHARORGID.
Estas extensiones admitidas para los usuarios de Experience Cloud y Salesforce Customer Identity se muestran bajo la URN urn:salesforce:schemas:extension:external:2.0. Los usuarios de Customer Identity tienen Asignaciones profileId de tipo external identity. Del mismo modo, los usuarios de Experience Cloud tienen Asignaciones profileId de tipo community.
-
accountId -
contactId -
community
Si los valores accountId o contactId no se proporcionan, Salesforce crea registros de contacto y cuenta para el usuario. El nuevo nombre de cuenta tiene el formato usernameJITUserAccount. Por ejemplo: user@corpname.orgJITUserAccount.
Estas extensiones aparecen bajo la URN urn:salesforce:schemas:extension:communities.
-
networkID -
networkName
Asignaciones de API de REST en Atributos de SCIM
Esta tabla muestra las asignaciones compatibles de campos de objeto de API de REST a atributos de esquema SCIM. Utilice esta hoja como una referencia rápida. Para obtener una vista más detallada de los atributos admitidos para cada esquema, incluyendo características, envíe una solicitud GET al extremo https://MyDomainName.my.salesforce.com/services/scim/v2/Schemas. Consulte Comprender la implementación de SCIM.
| CAMPO DE OBJETO DE API DE REST | ATRIBUTO DE ESQUEMA SCIM |
|---|---|
City
|
address.[type eq "work"].locality
|
CommunityNickname
|
nickName
|
CompanyName
|
No compatible |
Country
|
address.[type eq "work"].country
|
CreatedDate
|
created
|
Department
|
department
|
Division
|
division
|
Email
|
emails
|
EmailEncodingKey
|
emailEncodingKey
|
EmployeeNumber
|
employeeNumber
|
FederationIdentifier
|
ExternalID
|
FirstName
|
name.givenName
|
Id
|
Id
|
IsActive
|
active
|
LanguageLocaleKey
|
preferredLanguage
|
LastModifiedDate
|
lastModified
|
LastName
|
name.familyName
|
LocaleSidKey
|
locale
|
ManagerId
|
manager
|
MobilePhone
|
phoneNumbers.[type eq "mobile"].value
|
PermisisonSets
|
Entitlement
|
Phone
|
phoneNumbers.[type eq "work"].value
|
PostalCode
|
address.[type eq "work"].postalCode
|
ProfileId
|
Entitlement
|
ProfileName
|
Entitlement
|
State
|
address.[type eq "work"].region
|
TimeZoneSidKey
|
timezone
|
Title
|
title
|
Username
|
userName
|
UserPermissionsCallCenterAutoLogin
|
No compatible |
UserPermissionsMarketingUser
|
No compatible |
UserPermissionsOfflineUser
|
No compatible |
UserRoleId
|
Role
|

