Esportazione di tutti gli utenti

Prima di poter importare i tuoi profili nella tua nuova istanza, devi esportarli dalla tua istanza originale del servizio.

Se stai esportando molti utenti (16.000 o più), puoi utilizzare l'endpoint API export/all.

1. Esportare tutti gli utenti dall'istanza originale del servizio.

   curl -X POST 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/export/all' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer <IAMToken>' \
      --data-raw '{"encryptionSecret" : "<encryptionSecret>",  
   "emailAddress" : "jdoe@example.com"}'
   

2. Ottieni lo stato della richiesta, se necessario.

   curl -X GET 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/export/status?id=<id>' --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer <IAMToken>'
   

3. Quando l'esportazione è pronta o se la richiesta ha esito negativo, viene inviata un'e-mail all'indirizzo email fornito. Per scaricare l'esportazione, utilizzare l'API export/download.

   curl -X GET 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/export/download?id=<id>' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer <IAMToken>'
   

   Un file di esportazione viene creato solo quando la richiesta di esportazione ha esito positivo. Se la richiesta non riesce, per ridurre il rischio di vulnerabilità, i dati raccolti vengono eliminati. L'esportazione viene automaticamente eliminata dopo 7 giorni o il numero di giorni specificato nel corpo della richiesta (nell'intervallo compreso tra 1 e 30 giorni). Puoi scegliere di eliminare manualmente l'esportazione inviando una richiesta all'API delete.

   Descrizione dei parametri che devono essere forniti nella richiesta di esportazione/tutela

   Parametri	Descrizione
   encryptionSecret	Una stringa personalizzata utilizzata per codificare e decodificare una password con hash dell'utente. Mantieni il segreto di crittografia come ti serve per utilizzare l'API import/all. IBM non memorizza il segreto, quindi se il segreto viene perso, non è possibile accedere ai dati esportati.
   emailAddress	Un indirizzo email a cui viene inviata un'email quando l'esportazione è pronta o se la richiesta non riesce.
   expires	Un numero intero che è possibile impostare (1 ≤ valore ≤ 30) per specificare il numero di giorni dopo i quali l'esportazione deve essere eliminata. Il valore predefinito è 7.
   tenantID	L'ID tenant del servizio può essere trovato nelle tue credenziali del servizio. È possibile trovare o creare le credenziali del servizio nella dashboard App ID.

Esportazione di utenti in lotti

L'endpoint di esportazione è riservato alle esportazioni minori di circa 16.000 utenti. Per esportare tutti gli utenti Cloud Directory associati a un ID tenant specifico, utilizza l'endpoint API export/all.

1. Esporta gli utenti dalla tua istanza originale del servizio.

   curl -X GET 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/export?encryption_secret=mySecret' \
   -H 'Accept: application/json' \
   -H 'Authorization: Bearer <IAMToken>'
   

   Descrizioni dei parametri che devono essere forniti nella richiesta di esportazione

   Parametri	Descrizione
   encryptionSecret	Una stringa personalizzata utilizzata per codificare e decodificare una password con hash dell'utente.
   tenantID	L'ID tenant del servizio può essere trovato nelle tue credenziali del servizio. Puoi trovare le tue credenziali di servizio nel dashboard App ID.

   Vengono restituiti solo i tuoi utenti Cloud Directory e i loro profili. Gli utenti da altri provider di identità non vengono restituiti.

Importazione di tutti gli utenti

Ora che hai un elenco di utenti Cloud Directory esportati, puoi importarli nella nuova istanza. È possibile utilizzare l'endpoint API import-all per importare un numero considerevole di utenti (16.000 o più) con un'unica richiesta.

1. Importare l'elenco di utenti esportati scaricati.

   curl -X POST 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/import/all' \
   --header 'Content-Type: multipart/form-data' \
   --header 'Authorization: Bearer <IAMToken>' \
   --form 'file=@<User/desktop/myfolder/user_list.json>' \
   --form 'encryptionSecret=mySecret' \
   --form 'emailAddress=jdoe@example.com'
   

2. Ottieni lo stato della richiesta, se necessario.

   curl -X GET 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/import/status?id=<id>' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer <IAMToken>'
   

   Descrizioni dei parametri che devono essere forniti nella richiesta di importazione/tutela

   Parametri	Descrizione
   encryptionSecret	Una stringa personalizzata utilizzata per codificare e decodificare una password con hash dell'utente. Il segreto di codifica è lo stesso segreto che hai collegato all'API export/all. IBM non memorizza il segreto, quindi se il segreto viene perso, non è possibile accedere ai dati esportati.
   emailAddress	Un indirizzo email a cui viene inviata un'email quando l'esportazione è pronta o se la richiesta non riesce.
   tenantID	L'ID tenant del servizio può essere trovato nelle tue credenziali del servizio. È possibile trovare o creare le credenziali del servizio nella dashboard App ID.
   file	L'output dall'endpoint export/download.

Importazione di utenti in lotti

È possibile utilizzare l'endpoint API di importazione per importare pochi utenti alla volta. Puoi aggiungere fino a 50 utenti per richiesta con l'endpoint API di importazione. Per aggiungere tutti gli utenti tramite una sola richiesta, utilizza l'endpoint API import/all.

1. Se ai tuoi utenti sono assegnati dei ruoli, assicurati di creare i ruoli e gli ambiti nella tua nuova istanza di App ID.

   I ruoli e gli ambiti devono essere creati esattamente come erano nell'istanza precedente con le stesse grafie.

2. Gli utenti vengono importati con un nuovo identificativo di Cloud Directory. Se la tua applicazione fa riferimento all'identificativo Cloud Directory in qualsiasi modo, puoi scegliere di creare un attributo personalizzato e regolare la tua applicazione per richiamare l'attributo invece dell'identificativo direttamente.

3. Importa gli utenti alla tua nuova istanza del servizio.

   curl -X POST 'https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/cloud_directory/import?encryption_secret=mySecret'
   --header 'Content-Type: application/json'
   --header 'Accept: application/json'
   --header 'Authorization: Bearer <IAMToken>'
   -d '{"users": [
      {
         "scimUser": {
            "originalId": "3f3f6779-7978-4383-926f-a43aef3b724b",
            "name": {
            "givenName": "John",
            "familyName": "Doe",
            "formatted": "John Doe"
            },
            "displayName": "John Doe",
            "emails": [
            {
               "value": "user@example.com",
               "primary": true
            }
            ],
            "status": "PENDING"
         },
         "displayName": "Jane-Doe",
         "emails": [
            {
            "value": "jdoe@example.com",
            "primary": true
            }
         ],
         "status": "PENDING"
      },
      "passwordHash": "<passwordHashHere>",
      "passwordHashAlg": <passwordHashAlgorithm>,
      "profile": {
         "attributes": {}
      },
      "roles": []
      }
   ]}'
   

Script di migrazione per esportazioni e importazioni minori

App ID fornisce uno script di migrazione che puoi utilizzare tramite la CLI che può aiutare a velocizzare il processo di migrazione quando utilizzi gli endpoint API di esportazione o importazione. In alternativa, per rendere il processo di migrazione ancora più efficace, è possibile utilizzare gli endpoint API export/all e import/all.

1. Clona il repository.

git clone https://github.com/ibm-cloud-security/appid-sample-code-snippets/tree/master/export-import-cloud-directory-users.git

2. Nel terminale, passa alla cartella in cui hai clonato il repository.

3. Immetti il seguente comando.

   npm install
   

4. Con i tuoi parametri, immetti il seguente comando:

   users_export_import 'sourceTenantId' 'destinationTenantId' 'region' 'iamToken'
   

   Descrizioni dei parametri

   Parametro	Descrizione
   sourceTenantId	L'ID tenant dell'istanza di App ID da cui vuoi esportare gli utenti.
   destinationTenantId	L'ID tenant dell'istanza di App ID in cui vuoi importare gli utenti.
   region	Ulteriori informazioni sulle regioni disponibili.
   IAM token	Per ottenere un token IAM, consultare i documenti.

   Comando di esempio:

   users_export_import e00a0366-53c5-4fcf-8fef-ab3e66b2ced8 73321c2b-d35a-497a-9845-15c580fdf58c ng eyJraWQiOiIyMDE3MTAyNS0xNjoyNzoxMCIsImFsZyI6IlJTMjU2In0.eyJpYW1faWQiOiJJQk1pZC0zMTAwMDBUNkZTIiwiaWQiOiJJQk1pZC0zMTAwMDBUNkZTIiwicmVhbG1pZCI6IklCTWlkIiwiaWRlbnRpZmllciI6IjMxMDAwIFQ2RlMiPCJnaXZlbl9uYW1lIjoiUm90ZW0iLCJmYW1pbHlfbmFtZSI6IkJyb3NoIiwibmFtZSI6IlJvdGVtIEJyb3NoIiwiZW1haWwiOiJyb3RlbWJyQGlsLmlibS5jb20iLCJzdWIiOiJyb3RlbWJyQGlsLmlibS5jb20iLCJhY2NvdW50Ijp7ImJzcyI6ImQ3OWM5YTk5NjJkYzc2Y2JkMDZlYTVhNzhjMjY0YzE5In0sImlhdCI6MTUzNrE3Mjg4NCwiZXhwIjoxNTM3MTc2NDg0LCJpc3MiOiJodHRwczovL2lhbS5zdGFnZTEuYmx1ZW1peC5uZXQvaWRlbnRpdHkiLCJncmFudF90eXBlIjoidXJuOmlibTpwYXJhbXM6b2F1dGg6Z3JhbnQtdHlwZTpwYXNzY29kZSIsInNjb3BlIjoiaWJtIG9wZW5pZCIsImNsaWVudF9pZCI6ImJ4IiwiYWNyIjoxLCJhbXIiOlsicHdkIl19.c4vLPzhvvNZLjaLy7znDa37qV4o-yuGmSKmJoQKrEQNZU8IC0NIjxwSo7W9kb0pDi3Yf_03_9ufTTGNfjtltzNWycSXjkNgoL-b9_nU61oHdgn0stY1KmNicqyBWfgUU--4xa904QN_QjRHBaUBeJf3XWEphPIMoF7mZeOxEZLnCMcQXSz9pImCMiP4SNT38cHLiI90Yx01rM7hpteepWULh5MYh-B2V03Gkgxfqvv951HF1LDg6eT4Q9in11laTQKtKuomripUju_4GIIjORVYw9NaAVKIJ9lKrPX0SKPhStsa59qGsC_7Uersms5EY1W1VbZVqOZPJbtp6tVf-Lw