Cod.	Ultima revisione	Wiki	Note
956	2024/06/26 - MM	#177

Permette la registrazione di un nuovo utente tramite le API di Keycloak.

Descrizione

L'API di registrazione utente consente a un utente con privilegi di amministratore di creare nuovi utenti all'interno di un realm specifico in Keycloak. Questa API è accessibile tramite una richiesta HTTP POST e richiede che l'utente amministratore abbia i permessi adeguati per la gestione degli utenti. La registrazione include l'impostazione di informazioni di base come nome, cognome, email e credenziali dell'utente.

Per poter utilizzare questa API, è necessario:

• Configurare un utente come amministratore
• Ottenere Bearer Token

Version API: 22.0.5

Rif: https://www.keycloak.org/docs-api/22.0.5/rest-api/#_users


Endpoint: /admin/realms/{realm}/users


Method : POST

Params

• Realm: Nome del realm in cui l'utente verrà creato (non l'ID del realm).

Body

Il corpo della richiesta deve essere in formato JSON e deve includere i seguenti campi:

    {
        "firstName": "{FIRST_NAME}",
        "lastName": "{LAST_NAME}",
        "email": "{EMAIL}",
        "emailVerified": true,
        "enabled": true,
        "credentials": [{
            "type": "password",
            "value": "{PASSWORD}",
            "temporary": true
        }]
    }

Riferimenti

• UserRepresentation

Example

USER_ID=$(curl -s -k -i -X POST "https://dev-login.example.com/admin/realms/example/users" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${TOKEN}" \
--data-raw '{
"firstName": "user0001",
"lastName": "lastnameuser0001",
"email": "user0001@example.com",
"emailVerified": true,
"enabled": true,
"credentials":[{
"type": "password",
"value": "password'",
"temporary": true
}]
}' | grep "Location: <a href="https://dev-login.example.com/admin/realms/example/users"
"="">https://dev-login.example.com/admin/realms/exampl...</a> | grep -o '[^/]\+$' | tr -d '\r')
echo "User user0001@example.com created with ID ${USER_ID}"

Success Response

Code: ....
Content:

Error Response

Code: ....
Content:

Argomenti Correlati

• IDM Login (Keycloack) -
• Configurare un utente come amministratore -
• Ottenere Bearer token -