Exportando todos os usuários. "

Para que seja possível importar seus perfis para sua nova instância, é necessário exportá-los de sua instância original do serviço.

Se você estiver exportando muitos usuários (16.000 ou mais), será possível usar o terminal de API do export/all

1. Exporte todos os usuários da instância original do serviço.

   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. Obtem o status de seu pedido, conforme necessário.

   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 a exportação estiver pronta ou se a solicitação falhar, um e-mail é enviado para o endereço de e-mail fornecido. Para fazer o download da exportação, use a 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>'
   

   Um arquivo de exportação é criado apenas quando o pedido de exportação é bem-sucedido. Se a solicitação falhar, para reduzir seu risco de vulnerabilidade, os dados que estão reunidos são excluídos. A exportação é excluída automaticamente após 7 dias ou o número de dias especificado no corpo da solicitação (no intervalo de 1 a 30 dias). Você pode optar por excluir manualmente a exportação enviando uma solicitação para a API delete.

   Descrições dos parâmetros que precisam ser fornecidos na solicitação export/all

   Parâmetros	Descrição
   encryptionSecret	Uma sequência customizada que é usada para criptografar e decriptografar a senha em hash de um usuário. Retenha o segredo de criptografia conforme ele for necessário para usar a API import/all. IBM não armazem o segredo assim se o segredo for perdido, você não pode acessar os dados exportados.
   emailAddress	Um endereço de e-mail para o qual um e-mail é enviado quando a exportação está pronta ou se a solicitação falhar.
   expires	Um número inteiro que você pode configurar (1 ≤ valor ≤ 30) para especificar o número de dias após o qual a exportação deve ser excluída.. O valor padrão é 7.
   tenantID	O ID do locatário de serviço pode ser localizado em suas credenciais de serviço. Você pode encontrar ou criar suas credenciais de serviço no painel App ID.

Exportação de usuários em lotes

O ponto de extremidade de exportação é reservado para pequenas exportações de aproximadamente menos de 16.000 usuários. Para exportar todos os seus usuários do Cloud Directory que estão associados a um ID de inquilino específico, use o terminal de API export/all.

1. Exporte os usuários de sua instância original do serviço.

   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>'
   

   Descrições dos parâmetros que precisam ser fornecidos na solicitação de exportação

   Parâmetros	Descrição
   encryptionSecret	Uma sequência customizada que é usada para criptografar e decriptografar a senha em hash de um usuário.
   tenantID	O ID do locatário de serviço pode ser localizado em suas credenciais de serviço. É possível localizar suas credenciais de serviço no painel do App ID.

   Somente os usuários do Cloud Directory e seus perfis são retornados. Os usuários de outros provedores de identidade não são.

Importando todos os usuários

Agora que você tem uma lista de usuários exportados do Cloud Directory, é possível importá-los para a nova instância. Você pode usar o endpoint import-all API para importar um número substancial de usuários (16.000 ou mais) com uma única solicitação.

1. Importe a lista de usuários exportados que você baixou.

   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. Obtem o status de seu pedido, conforme necessário.

   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>'
   

   Descrições dos parâmetros que precisam ser fornecidos na solicitação de importação/todos

   Parâmetros	Descrição
   encryptionSecret	Uma sequência customizada que é usada para criptografar e decriptografar a senha em hash de um usuário. O segredo de criptografia é o mesmo segredo que você anexou à API export/all. IBM não armazem o segredo assim se o segredo for perdido, você não pode acessar os dados exportados.
   emailAddress	Um endereço de e-mail para o qual um e-mail é enviado quando a exportação está pronta ou se a solicitação falhar.
   tenantID	O ID do locatário de serviço pode ser localizado em suas credenciais de serviço. Você pode encontrar ou criar suas credenciais de serviço no painel App ID.
   file	A saída a partir do terminal export/download.

Importação de usuários em lotes

Você pode usar o endpoint da API de importação para importar alguns usuários de cada vez. Você pode adicionar até apenas 50 usuários por solicitação com o terminal de API de importação. Para adicionar todos os seus usuários através de uma única solicitação, use o terminal de API import/all.

1. Se seus usuários tiverem funções designadas, certifique-se de criar as funções e os escopos em sua nova instância do App ID.

   As funções e os escopos devem ser criados exatamente como eles estavam na instância anterior com as mesmas ortografias.

2. Os usuários são importados com um novo identificador do Cloud Directory. Se o seu app referenciar o identificador do Cloud Directory de qualquer maneira, será possível escolher criar um atributo customizado e ajustar o seu aplicativo para chamar o atributo em vez de o identificador diretamente.

3. Importe os usuários para sua nova instância do serviço.

   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 de migração para pequenas exportações e importações

O App ID fornece um script de migração que você pode usar por meio da CLI que pode ajudar a acelerar o processo de migração ao usar os terminais de API de exportação ou importação. Alternativamente, para tornar o processo de migração ainda mais eficiente, você pode usar os terminais de API export/all e import/all.

1. Clone o repositório.

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

2. No terminal, mude para a pasta na qual você clonou o repositório.

3. Execute o seguinte comando.

   npm install
   

4. Com seus parâmetros, execute o comando a seguir.

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

   Descrições de parâmetros

   Parâmetro	Descrição
   sourceTenantId	O ID do locatário da instância do App ID da qual você planeja exportar os usuários.
   destinationTenantId	O ID do locatário da instância do App ID para a qual você planeja importar os usuários.
   region	Saiba mais sobre as regiões disponíveis.
   IAM token	Para obter ajuda ao adquirir um token do IAM, consulte os docs.

   Exemplo de comando:

   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