Gerenciando perfis

Visualização de perfis de usuário no console

Para ver os dados que estão disponíveis para seus usuários do app, é possível usar a IU do App ID.

1. Navegue para a guia Perfis do usuário > Perfis de sua instância do App ID.

2. Examine a tabela ou procure usando um endereço de e-mail para localizar o usuário do qual você deseja ver as informações. O termo de procura deve ser exato.

3. No menu overflow da linha do usuário, clique em Visualizar perfil do usuário. É aberta uma página contendo as informações sobre o usuário. Verifique a tabela a seguir para ver quais informações você pode ver.

   Detalhes do usuário, conforme mostrado no painel App ID

   Detail	Descrição
   Identificador IdP	O identificador IdP é emitido pelo provedor que seu usuário escolheu para se conectar ao seu aplicativo com ele.
   E-mail	O endereço de e-mail principal anexado ao usuário.
   Nome	O nome e o sobrenome do seu usuário, conforme emitido pelo provedor de identidade.
   Provedor de identidade	O provedor com o que seu usuário escolheu se conectar.
   ID	O ID designado ao usuário pelo App ID.
   Atributos customizados	Atributos customizados são informações adicionais incluídas no perfil ou que são aprendidas sobre os usuários, à medida que eles interagem com seu aplicativo.
   Resumo	Todas as informações que estão associadas a esse usuário são mostradas como um objeto JSON.

Visualizando perfis do usuário com a API

É possível usar a API do App ID para visualizar detalhes sobre os usuários do app.

1. Obtenha seu ID de locatário em sua instância do serviço. É possível localizar o ID em suas credenciais de serviço ou de aplicativo.

2. Procure seus usuários do App ID com uma consulta de identificação, como um endereço de e-mail, para localizar a identificação de usuário.

   curl -X GET "https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/Users?query=<identifyingSearchQuery>" \
   -H "accept: application/json" \
   -H "authorization: Bearer <token>"
   

   Exemplo:

   curl -X GET https://us-south.appid.cloud.ibm.com/management/v4/e19a2778-3262-4986-8875-8khjafsdkhjsdafkjh/cloud_directory/Users?query=example@domain.com -H "accept: application/json" -H "authorization: Bearer eyJraWQiOiIyMDE3MTEyOSIsImFsZ...."
   

3. Usando o ID que você obteve na etapa anterior, faça uma solicitação GET para o terminal /users para ver seu perfil do usuário integral.

   curl -X GET "https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/users/<userID>/profile" \
   -H "accept: application/json" \
   -H "authorization: Bearer <token>"
   

   Resposta de exemplo:

   {
      "id": "a0791903-ed4c-41cf-bd0e-a37957dad820",
      "name": "David Test-user",
      "email": "dave.test@domain.com",
      "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic/?asid=11122233344455566&height=50&width=50&ext=1569429199&hash=AaAaAAAAAaAAAaaA",
      "identities": [
         {
         "provider": "facebook",
         "id": "11122233344455566",
         "idpUserInfo": {
               "id": "11122233344455566",
               "name": "David Test-user",
               "picture": {
               "data": {
                  "height": 50,
                  "is_silhouette": false,
                  "url": "https://platform-lookaside.fbsbx.com/platform/profilepic/?asid=11122233344455566&height=50&width=50&ext=1569429199&hash=AaAaAAAAAaAAAaaA",
                  "width": 50
               }
               },
               "first_name": "David",
               "last_name": "Test-user",
               "email": "dave.test@domain.com",
               "idpType": "facebook"
         }
         }
      ],
      "attributes": {
         "role": "admin"
      }
   }
   

   Para ver o conjunto completo de dados do usuário que o site App ID suporta, consulte o esquema principal do SCIM.

Definição de atributos personalizados no console

É possível incluir informações customizadas sobre seus usuários nos perfis deles, como a função ou a preferência que eles têm, configurando um atributo customizado. Para configurar um atributo, é possível usar a IU do App ID.

Por padrão, os atributos customizados são modificáveis e podem ser atualizados usando um token de acesso do App ID por meio de um aplicativo cliente. Sem tomar as devidas precauções, o usuário ou o aplicativo pode atualizar atributos customizados imediatamente após a primeira conexão do usuário, se eles tiverem um token de acesso. Isso pode levar potencialmente a consequências indesejadas. Por exemplo, um usuário pode mudar sua função de usuário para administrador, o que pode expor privilégios administrativos a usuários maliciosos.

1. Acesse a guia Perfis do usuário > Configurações do painel do App ID.

2. Alterne atributos customizados para Ativado.

3. Clique em Visualizar Perfil no menu overflow da linha para o usuário para o qual você deseja configurar o atributo.

4. Na seção Atributos customizados, clique em Editar.

5. Insira os atributos que você deseja incluir como um objeto JSON. Por exemplo, {"role":"admin"}.

Setting custom attributes with the API

Como administrador, é possível incluir informações customizadas sobre seus usuários nos perfis deles, como a função ou a preferência que eles têm, configurando um atributo customizado. Para configurar um atributo, é possível usar a API App ID para chamar o terminal /users. Para configurar atributos customizados antes que um usuário se conecte em seu aplicativo pela primeira vez, consulte Registrando previamente os usuários futuros.

Por padrão, os atributos customizados são modificáveis e podem ser atualizados usando um token de acesso do App ID por meio de um aplicativo cliente. Isso significa que, sem tomar precauções adequadas, o usuário ou o aplicativo poderão atualizar os atributos customizados imediatamente após a primeira conexão do usuário, se eles tiverem um token de acesso. Isso pode levar potencialmente a consequências indesejadas. Por exemplo, um usuário pode mudar sua função de usuário para administrador, o que pode expor privilégios administrativos a usuários maliciosos.

1. Acesse a guia Perfis do usuário > Configurações do painel do App ID.

2. Alterne atributos customizados para Ativado.

3. Obtenha um token do IAM.

   1. No painel do IBM Cloud, clique em Gerenciar > Acesso (IAM).

   2. Selecione **IBM Cloud Chaves API **.

   3. Clique em Criar uma chave de API do IBM Cloud.

   4. Dê um nome a sua chave e descreva-a. Clique em Criar. Uma tela é exibida com sua chave.

   5. Clique em Copiar ou Fazer download de sua chave. Ao fechar a tela, não é mais possível acessar a chave.

   6. Faça a solicitação cURL a seguir com a chave de API que você criou.

      curl -k -X POST \
      --header "Content-Type: application/x-www-form-urlencoded" \
      --header "Accept: application/json" \
      --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey" \
      --data-urlencode "apikey=<apikey>" \
      "https://iam.cloud.ibm.com/identity/token"
      

4. Faça uma solicitação de PUT para o terminal /users.

   curl -X PUT "https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/users/<userID>/profile" \
   -H "accept: application/json" \
   -H "Content-Type: application/json" \
   -H "authorization: Bearer <token>"
   -d "{ \"attributes\": { \"points\": \"150\" } { \"role\": \"admin\" }}"
   

Exclusão de um perfil no console

Como administrador, é possível remover alguém como usuário de seu aplicativo excluindo o perfil dele.

1. Navegue para a guia Perfis do usuário > Perfis de sua instância do App ID.

2. Examine a tabela ou procure usando um endereço de e-mail para localizar o usuário do qual você deseja ver as informações. O termo de procura deve ser exato.

3. No menu overflow da linha do usuário, clique em Excluir. Uma tela de confirmação é aberta.

4. Verifique se você está excluindo o usuário correto verificando seu e-mail com relação ao exibido. Se ele for o usuário correto, clique em Excluir. Essa ação não pode ser desfeita O usuário pode ser adicionado novamente, mas seu perfil mostra que ele é um novo usuário a partir da data em que foi adicionado novamente.

Excluindo um perfil com a API

Como administrador, é possível remover alguém como usuário de seu aplicativo excluindo o perfil dele.

1. Obtenha seu ID de locatário em sua instância do serviço. É possível localizar o ID em suas credenciais de serviço ou de aplicativo.

2. Procure seus usuários do App ID com uma consulta de identificação, como um endereço de e-mail, para localizar a identificação de usuário.

   curl -X GET "https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/Users?query=<identifyingSearchQuery>" \
   -H "accept: application/json" \
   -H "authorization: Bearer <token>"
   

   Exemplo:

   curl -X GET https://us-south.appid.cloud.ibm.com/management/v4/e19a2778-3262-4986-8875-8khjafsdkhjsdafkjh/cloud_directory/Users?query=example@domain.com -H "accept: application/json" -H "authorization: Bearer eyJraWQiOiIyMDE3MTEyOSIsImFsZ...."
   

3. Usando o ID que você obteve na etapa anterior, faça uma solicitação DELETE para o terminal /users a fim de excluir o perfil.

   curl -X DELETE "https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/users/<userID>/profile" \
   -H "accept: application/json" \
   -H "authorization: Bearer <token>"