TOTVS Fluig

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Lucas Vinicius Schiochet

Gravado em

comparado com

Nova versão 6

changes.mady.by.user Leoberto Jose Preuss Junior

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

APIs para User Experience

 

Este tutorial explica como utilizar as APIs fluig Identity para as funcionalidades de User Experience baseadas em SCIM. APIs baseadas em SCIM são um subconjunto de APIs REST do Fluig Identity, que estão documentadas neste artigo. 

 

Localização das APIs 

https://app.fluigidentity.com/rest/swagger-ui/index.html

 

 

Prepare o Ambiente

Este tutorial utiliza um cliente SOAP para acessar as APIs REST do

Fluig

fluig Identity. Este conjunto de instruções demonstra a configuração do cliente.

  1. Faça o download do aplicativo SoapUI em http://www.soapui.org/
  2. Abra o aplicativo SoapUI
  3. Faça o download do projeto teste CloudPass-Rest-soapui-project.xml
  4. Importe o projeto teste CloudPass-Rest-soapui-project.xml

    Image Modified

  5. Clique em File
->Import
  1. > Import Project

    Image Modified
  2. Selecione o arquivo CloudPass-Rest-soapui-project.xml
    Image Modified

 

 

Cliente SOAP para Windows

 

O projeto importado possuí exemplo possui exemplos de dados e chamadas das APIs. Para entender a estrutura da API, nós podemos olhar observar a chamada Create User.

Lembre-se de definir o endpoint para o sandbox de desenvolvedores desenvolvedores.

1) navegue Navegue para Users > Create User > Post e clique em Request 1

Na imagem abaixo:

1 é . É o nome da API e seu caminho relativo

2 é . É o método HTTP da API

3 é . É o link da janela de requisição, de . Dê um duplo - clique para abrir a janela de detalhes da API.

 

 

Na imagem abaixo:

 

1 contém . Contém a área para parâmetros de urlURL

2 contém . Contém a área do corpo da requisição httpHTTP

3 contém . Contém o botão send request

 

 

APIs de Usuário

 

As APIs de Usuário possuem 4 funções: Create, get, update and deleteGet, Update e Delete.

 

Esta sessão irá utilizar 6 passos para demonstrar essas funções.

    1. Criar um novo usuário
    2. Obter os dados de um usuário pelo id
    3. Atualizar usuário
    4. Obter o usuário atualizado
    5. Remover um usuário pelo id
    Obter
    1. Ao tentar obter o usuário removido,
    irá retornar uma mensagem de
    1. a chamada retorna um erro

 

Criar um novo Usuário

  1. Navegue para Users > Create User > POST e clique em Request 1

  2. Insira os dados do novo usuário, e clique no botão sendbotão Send

  3. Verifique o retorno clicando na aba JSON

Obter dados do usuário pelo id

  1. Navegue para Users > Create User >  > Get User by Id > GET e clique em Request 1

  2. Insira o valor do userId na área de parâmetros de urlURL
  3. Clique no botão send request, espere pelo aguarde o resultado e verifique o mesmo.
 

 

Atualizar usuário

  1. Navegue para Users > Update User > PUT e clique em Request 1

  2. Mude o campo displayName para "jacob-update"

  3. Clique no botão send request, espere pelo aguarde o resultado e então verifique o mesmo.

 

Remover usuário pelo userId

  1. Navegue para Users > Update  > Delete User > DELETE e clique em Request 1

  2. Insira o userId

  3. Clique no botão send request, espere pelo resultado e verifique o mesmo.

 

 

Obter

Ao tentar obter um usuário removido, a chamada retorna um erro

Use a chamada GET para o ID do usuário que acabou de ser removido (veja acima)

 

 

APIs de Recursos

 

Recursos são implementados para serem utilizados como opções de menu, mas podem ser extendidos estendidos para outras aplicações.

Nesta seção nós iremos aprender como criar, listar e deletar um recurso.

Este cenário de teste segue os seguintes casos de teste.

    • Criar três recursos: menu1, menu2, menu3 para aplicação
    • Obter o recurso menu1 pelo id
    • Obter todos os recursos de aplicações, irá obter três recursos: menu1, menu2, menu3
    • Remover o recurso menu1 pelo id
    • Obter o recurso menu1 pelo id, irá retornar uma mensagem de erro
    • Obter todos os recursos de aplicações, irá obter dois recursos: menu2, menu3
    • Remover todos os recursos de aplicações
    • Obter todos os recursos de aplicações, não irá obter nenhum recurso

 

Criar três recursos: menu1, menu2, menu3 para aplicação

  1. Navegue para Resources > Create Resource > POST e clique em Request 1

  2. Insira os dados dos recursos menu1, menu2, menu3 e o applicationId


  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

 

Obter o recurso menu1 pelo id

  1. Navegue para Resources > Get Resource > GET e clique em Request 1



  2. Insira o id do menu1



  3. Clique no botão send request, espere pelo resultado e verifique o mesmo.

 

Obter todos os recursos de aplicações, irá obter três recursos: menu1, menu2, menu3

  1. Navegue para Resources > Get All Resources > GET e clique em Request 1



  2. Insira o applicationId



  3. Clique no botão send request, espere pelo resultado e verifique o mesmo.

 

Remova o recurso menu1 pelo id

  1. Navegue para Resources > Delete by Id > DELETE e clique em Request 1

  2. Insira o id do recurso menu1


  3. Clique no botão send request, espere pelo resultado e verifique o mesmo.
    • Obter o recurso menu1 pelo id, irá retornar uma mensagem de erro
    • Obter todos os recursos de aplicações, irá obter dois recursos: menu2, menu3
    • Remover todos os recursos de aplicações
    • Obter todos os recursos de aplicações, não irá obter nenhum recurso

 

 

 

APIs de Papéis

 

Papéis são conexões entre usuários e direitos.

Este cenário de testes inclui os seguintes testes de caso:

  • Criar dois papéis: "user" e "admin" para a empresa
  • Obter o papel papel "user pelo " pelo id
  • Obter todos os papéis da empresa, irá retornar dois papéis: "user", "admin"
  • Remover o papel "user" pelo id
  • Obter o papel "user" pelo id, irá retornar uma mensagem de erro
  • Obter todos os papéis da empresa, irá retornar um papel: "admin"
  • Remover todos os papéis de uma empresa
  • Obter todos os papéis da empresa, irá retornar um erro

Criar dois papéis: "user" e "admin" para a empresa

  1. Navegue para Roles > Create Roles > POST e clique em Request 1



  2. Insira o valor companyId e os dados para os papéis "user" e "admin"



  3. Clique no botão send request, espere pelos resultados e verifique o retorno.
    • Obter o papel user pelo id
    • Obter todos os papéis da empresa, irá retornar dois papéis: "user", "admin"
    • Remover o papel "user" pelo id
    • Obter o papel "user" pelo id, irá retornar uma mensagem de erro
    • Obter todos os papéis da empresa, irá retornar um papel: "admin"
    • Remover todos os papéis de uma empresa
    • Obter todos os papéis da empresa, irá retornar um erro

 

 

APIs de Direitos

 

Direitos é são como os recursos são atribuídos aos usuários.

Este cenário de testes contém os seguintes casos de teste:

  • Criar o usuário "Jacob"
  • Criar os recursos "menu1", "menu2", "menu3"
  • Atribuir os recursos "menu1", "menu2" para o usuário "Jacob"
  • Get all resources which entitled to user "Jacob", will get "menu1", "menu2"
  • Delete all entitled resources from user "Jacob"Get all resources which entitled to user
  • Obter todos os recursos que possuam direitos para o usuários "Jacob", will get error
Create user
  • irá retornar erro

Criar usuário "Jacob"

  1. Navegue para Users > Create User > POST e clique em Request 1

  2. Insira os dados do novo usuário, e clique no botão send

  3. Aguarde os resultados e verifique os mesmos

 

Criar os recursos "menu1", "menu2" e "menu3"

  1. Navegue para Resources > Create Resource > GET e clique em Request 1

  2. Insira os dados dos recursos menu1, menu2 e menu3 e preencha o applicationId
  3. Clique no botão send request, espere os resultados e verifique o mesmo.

 

 

Atribua

Atribuir os recursos "menu1" e "menu2" para o usuário "Jacob"

  1. Navegue para Entitlements > Assign Resources to User > POST e clique em Request 1

  2. Insira o userId e o valor do id dos recursos "menu1" e "menu2"
  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

Adicione para o usuário "Jacob" o recurso "menu2" como favorito

  1. Navegue para Entitlements > Get Resources of User > GET e clique em Request 1

  2. Insira o userId

  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

 

Deletar todos os recursos com direitos do usuário "Jacob"

  1. Navegue para Entitlements > Unassign all Resources to User > DELETE e clique em Request 1

  2. Insira o userId

  3. Clique no botão send request, espere pelo resultado e verifique se o mesmo não possui nenhum direito.

 

Obter todos os recursos que possuam direitos para o usuário "Jacob", irá retornar um erro

  1. Navegue para Entitlements > Unassign all Resources to User > DELETE e clique em Request 1

  2. Insira o userId

  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

APIs de Favoritos

 

Marcações de favoritos adicionadas a recursos para o usuário.

Este cenário de teste incluí os seguintes casos de teste:


  • Criar o usuário "Jacob"
  • Criar os recursos "menu1", "menu2" e "menu3"
  • Atribuir os recursos "menu1" e "menu2" para o usuário "Jacob"
  • Adicionar o recurso "menu" como favorito do usuário "Jacob"
  • Obter os favoritos do usuário "Jacob" , irá retornar "menu2"
  • Remover os favoritos do usuário "Jacob"
  • Obter os favoritos do usuário "Jacob", irá retornar uma mensagem de erro

Navegue para Users > Create User > POST e clique em Request 1


Obter os favoritos do usuário "Jacob", irá retornar "menu2"

  1. Navegue para Favorites > Get user's Favorites > GET e clique em Request 1


  2. Insira os dados do novo usuário, e clique no botão send

  3. Espere o resultado e verifique o mesmo

 

Crie os recursos "menu1", "menu2" e "menu3"

  1. Navegue para Resources > Get All Resources of Application > GET e clique em Request 1



  2. Insira os dados dos recursos menu1, menu2 e menu3 e preencha o applicationId
  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

Adicionando os recursos "menu1" e "menu2" para o usuário "Jacob"

  1. Navegue para Entitlements > Assign Resources to User > POST e clique em Request 1
  2. Insira o userId e o id dos recursos "menu1" e "menu2"
  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

Adicione o recurso "menu2" como favorito do usuário "Jacob"

  1. Navegue para Favorites > Add Favorites to User > POST e clique em Request 1



  2. Insira o userId e o id recurso "menu2" como favorito


  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

Obter os favoritos do usuário "Jacob", irá retornar "menu2"

  1. Navegue para Favorites > Get user's Favorites > GET e clique em Request 1
  2. Insira o userId
  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

 

Remover os favoritos do usuário "Jacob"

  1. Navegue para Favorites > Delete user's Favorites > DELETE e clique em Request 1
  2. Insira o userId
  3. Clique no botão send request, espere pelo resultado e verifique o mesmo

Remover os favoritos do usuário "Jacob"

  1. Navegue para Favorites > Delete user's Favorites > DELETE e clique em Request 1
  2. Insira o userId
  3. Clique no botão send request, espere o resultado e verifique o mesmo. Nenhum dado de favoritos irá aparecer.