Gestione delle credenziali delle attività
Le credenziali dell'attività sono una chiave API generata dall'utente, archiviata in modo sicuro nel Vault, che facilita l'autenticazione per le richieste ai servizi IBM Cloud. Le credenziali delle attività sono utilizzate per eseguire determinate attività in un servizio o per consentire l'esecuzione di operazioni lunghe, come i lavori pianificati, senza interruzioni.
In Cloud Pak for Data as a Service, le chiavi API IBM Cloud sono utilizzate come credenziali dell'attività. Puoi fornire una chiave API IBM Cloud esistente oppure puoi generare una nuova chiave. È possibile memorizzare una sola credenziale di attività per utente, per account IBM Cloud.
Le credenziali per le attività rendono disponibili le chiavi API per i carichi di lavoro asincroni e di lunga durata che vengono attivati da azioni eseguite dall'utente nell'interfaccia del prodotto. Non si utilizzano le credenziali dell'attività quando si interagisce con Cloud Pak for Data as a Service in modo programmatico.
Se il servizio richiede una credenziale per eseguire un'operazione, viene richiesto di fornirla sotto forma di chiave API (esistente o generata ex novo).
Qualsiasi utente con un account IBM Cloud può creare una chiave API. Gli amministratori dei servizi hanno la responsabilità di definire una strategia per revocare le credenziali delle attività quando non sono più necessarie.
Accesso alle credenziali dell'attività
Per accedere alle credenziali dell'attività, procedere come segue:
Effettuare l'accesso a Cloud Pak for Data (
https://dataplatform.cloud.ibm.com/
) e poi andare alla scheda del proprio profilo:Scegliere Profilo e impostazioni: "
Scegliere la scheda Chiave API utente:
Creazione di credenziali di attività dall'interfaccia utente
Per creare nuove credenziali per le attività:
Dalla scheda Chiave API utente, fare clic su Crea chiave. La nuova chiave API apparirà nell'elenco delle chiavi:
Creazione di credenziali di attività a livello di programmazione
Scenario 1: Creazione di credenziali di attività per un ID di servizio esistente
Se si utilizza serviceIDs, non è possibile utilizzare UI Path per creare credenziali di attività. È necessario eseguire la seguente richiesta cURL per creare una credenziale di attività per l' serviceID
a specificata. Questa credenziale verrà utilizzata per creare distribuzioni, lavori di distribuzione e altre operazioni correlate:
curl -X POST "https://<your cloud URL>/v1/task_credentials?owner.user_id=<your IBM user ID>&owner.account_id=<your IBM account ID>" \
-H "accept: application/json" \
-H "Authorization: Bearer <your service id api key token>" \
-H "Content-Type: application/json" \
-d '{
"name": "SERVICE_ID_TASK_CREDENTIALS",
"description": "string",
"type": "iam_api_key",
"secret": {
"api_key": "<your service id apikey>"
}
}'
Ripetere l'operazione per tutte le località geografiche. Per i dettagli, fare riferimento agli URL delle località geografiche disponibili.
Dopo aver creato le credenziali dell'attività, attendere 15-20 minuti prima di riattivare i lavori o le distribuzioni non riusciti (misura precauzionale) in modo che i dati vengano sincronizzati per le credenziali dell'attività appena create.
Scenario 2: Creazione di credenziali di attività per utenti regolari (utilizzando API)
Esegui la seguente richiesta di credenziali ( cURL ) per creare un'attività:
curl -X POST "https://<your cloud URL>/v1/task_credentials?owner.user_id=<your IBM user ID>&owner.account_id=<your IBM account ID>" \
-H "accept: application/json" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "USER_TASK_CREDENTIALS",
"description": "string",
"type": "iam_api_key",
"secret": {
"api_key": "<your api key>"
}
}'
Ripetere l'operazione per ogni altra posizione. Per i dettagli, fare riferimento agli URL delle località geografiche disponibili.
URL delle località geografiche disponibili
Gestione delle credenziali delle attività esistenti
Per rigenerare la chiave, dalla scheda Chiave API utente, fare clic su Ruota chiave. La nuova chiave API apparirà nell'elenco delle chiavi.
Per eliminare la chiave, dalla scheda Chiave API utente, fare clic sull'icona Elimina.
Ulteriori informazioni
Argomento principale: Amministrazione di progetti