Loading
Identificazione degli utenti e gestione degli accessi
Esempi: Disattivazione e riattivazione degli utenti con SCIM

Esempi: Disattivazione e riattivazione degli utenti con SCIM

In Salesforce, gli oggetti utente vengono disattivati anziché eliminati. Disattivando un oggetto utente, lo stato attivo dell'utente diventa false. Sebbene sia ancora possibile eseguire query per l'oggetto utente, l'utente non potrà accedere a Salesforce con l'account disattivato. Per consentire a un utente di accedere, è possibile riattivarne l'account.

Versioni (Edition) richieste

Disponibile in: Salesforce Classic e Lightning Experience
Disponibile in: tutte le versioni

Per sapere come disattivare e riattivare gli account utente, esaminare gli esempi seguenti.

Disattivazione di un utente con PATCH

Per disattivare un utente, inviare una richiesta PATCH all'endpoint Users, come mostrato nell'esempio seguente.

Richiesta:

PATCH https://mycompany.my.salesforce.com/services/scim/v2/Users/<user_Id>

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "replace",
      "value": {
        "active": false
      }
    }
  ]
}

Risposta:

HTTP/1.1 200 OK
…

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
  ],
  "id": "0054W00000...",
  "userName": "scimuser@mycompany.com",
  "externalId": "scimUser",
  "name": {
    "formatted": "User Scim",
    "familyName": "Scim",
    "givenName": "User"
  },
  "displayName": "User Scim",
  "nickName": "user2",
  "emails": [
    {
      "type": "work",
      "primary": true,
      "value": "user@mycompany.com"
    }
...  

  "meta": {
    "created": "2020-10-22T06:21:45Z",
    "lastModified": "2020-10-25T09:21:43Z",
    "location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/0054W000...",
    "resourceType": "User",
    "version": "6a91c1386738961d6b223b2c6ef860715f2ab155"
  }
}

Disattivazione di un utente con DELETE

È anche possibile disattivare un utente con una richiesta DELETE, come mostrato di seguito. Il risultato è lo stesso della disattivazione di un utente con una richiesta PATCH. Lo stato attivo dell'oggetto utente viene aggiornato a false. In questo esempio, si noti che il codice di risposta include solo un codice HTTP. Il codice indica che la richiesta è riuscita.

Richiesta:

DELETE https://mycompany.my.salesforce.com/services/scim/v2/Users/<user_id>

Risposta:

HTTP/1.1 204 No Content

Riattivazione di un utente

È possibile riattivare un oggetto utente inviando una richiesta PATCH all'endpoint Users. Di seguito è riportato un esempio di richiesta.

Richiesta:

PATCH https://mycompany.my.salesforce.com/services/scim/v2/Users/<user_id>

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:PatchOp"
  ],
  "Operations": [
    {
      "op": "replace",
      "value": {
        "active": true
      }
    }
  ]
}

Risposta:

HTTP/1.1 200 OK
…

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
  ],
  "id": "0054W00000CVREkQAP",
  "userName": "scimuser@mycompany.com",
  "externalId": "scimUser",
  "name": {
    "formatted": "User Scim",
    "familyName": "Scim",
    "givenName": "User"
  },
  "displayName": "User Scim",
  "nickName": "user2",
  "emails": [
    {
      "type": "work",
      "primary": true,
      "value": "user@mycompany.com"
    }
  ...

  "meta": {
    "created": "2020-10-22T06:21:45Z",
    "lastModified": "2020-10-25T15:18:57Z",
    "location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/0054W00000CVREkQAP",
    "resourceType": "User",
    "version": "b5f45d87e1a39af1f10ef8d16fd7f61a30c171ed"
  }
}
 
Caricamento
Salesforce Help | Article