Loading
Identificar sus usuarios y gestionar el acceso
Hoja de referencia de SCIM y API de REST

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: POST

Leer: GET

Actualizar: PATCH

Desactivar: PATCH o DELETE

https://MyDomainName.my.salesforce.com/services/scim/v2/Groups Vea y gestione grupos públicos a los que pertenecen usuarios.

Leer: GET

Actualizar: PATCH

Reglas de operaciones

Al redactar operaciones SCIM, tenga en cuenta estas reglas.

  • En una cláusula, AND no tiene prioridad sobre OR. Si una cláusula contiene tanto AND como OR, 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
    Nota En el contexto de esta URN, el campo extension describe 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 (managerId y displayName)
  • delegatedApprover (delegatedApproverId y displayName)
  • 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
 
Cargando
Salesforce Help | Article