/auth/v1/token: GET

Richiama il token di autenticazione per l'utente.

La seguente tabella mostra i ruoli che possono accedere a questo endpoint API REST:
Tabella 1. Accesso per ruolo
Amministratore dati Utente dati Amministratore raccolta Amministratore Utente servizio
✓ ✓ ✓ ✓ ✓

Sinossi della richiesta URL

Gli utenti da un dominio LDAP o COS esterno devono includere il nome dominio nel nome utente come < dominio> / < utente> per ottenere un token di autenticazione.

curl -k -u ldap/user1:pass https://<data_cataloging_host>/auth/v1/token -v 
curl -k -u cos/user1:pass https://<data_cataloging_host>/auth/v1/token -v 
curl -k -u cos/<access_key_id>:<secret_key> https://<data_cataloging_host>/auth/v1/token -v

Senza specificare il nome dominio come parte del nome utente:

curl -k -u user1:pass https://<data_cataloging_host>/auth/v1/token -v
Nota: quando si utilizza curl, aggiungi il parametro -v per vedere le intestazioni della risposta che contengono il token.

Tipi di richiesta e formati di risposta supportati

Tipi di richieste supportate:
  • GET
Formati di risposta supportati:
  • JSON

I dati di risposta predefiniti sono in formato CSV. Per i risultati in formato JSON, utilizzare l'intestazione "Accept: application / json".

Esempi

Il seguente esempio mostra una richiesta e la risposta corrispondente.

Richiesta che contiene il dominio come parte del nome utente:
curl -k -u ldap/user1:pass https://<data_cataloging_host>/auth/v1/token -v
Richiesta che non contiene il dominio come parte del nome utente:
curl -k -u user1:pass https://<data_cataloging_host>/auth/v1/token -v

Risposta:

< HTTP/1.0 200 OK
< X-Auth-Token: gAAAAABbUdgLOLk67Zk_XQO0bbJt_qe4suz449m7XLM-D6e0jUzDxBW574L38y5xF5y3wc-
Xq0Bp43uQH13QN-wTsioPoOfOlbyrN5avBag2iHUkCOgXyA46TvY5LdGu46LEs-gO-
qidQgUCg5im4QF3Zvw5enCTvQd2N1bAg186CVOc8Qk5o1ldJGd51nL3ELts0LsVg9F4oPhv9HixwZflhlCsuPg1Gw
< Content-Type: text/html; charset=utf-8
< Content-Length: 0
< Server: Werkzeug/0.14.1 Python/2.7.5
< Date: Fri, 20 Jul 2018 12:39:39 GMT

È necessario utilizzare il token ottenuto nel passaggio precedente per accedere ai servizi offerti da IBM Data Cataloging.

Il seguente esempio mostra come utilizzare il token ottenuto per ottenere l'elenco da Policy Engine:

curl -v -k -H ‘Authorization: Bearer gAAAAABbUdgLOLk67Zk_XQO0bbJt_qe4suz449m7XLM-
D6e0jUzDxBW574L38y5xF5y3wc-Xq0Bp43uQH13QN-wTsioPoOfOlbyrN5avBag2iHUkCOgXyA46TvY5LdGu46LEs-
gO-qidQgUCg5im4QF3Zvw5enCTvQd2N1bAg186CVOc8Qk5o1ldJGd51nL3ELts0LsVg9F4oPhv9HixwZflhlCsuPg1Gw’ 
https://<data_cataloging_host>/policyengine/v1/policies