iGRPIGRP 3.0Documentation

Utilizadores

Gerir utilizadores, os seus perfis, o perfil ativo e as permissões.

Listar utilizadores

GET
/api/users

Permissão: igrp.users.list.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de query

applicationCode?string
departmentCode?string
name?string
id?string
email?string

Corpo da resposta

OK

application/json
  1. response
id?string
name?string
username?string
email*string
Formatoemail
Comprimento1 <= length
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
picture?string
signature?string
nic?string
Comprimento0 <= length <= 13
phoneNumber?string
Padrão^\+[1-9]\d{1,14}$
emailVerified?boolean
metadata?
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users'
{  "id": "string",  "name": "string",  "username": "string",  "email": "user@example.com",  "status": "ACTIVE",  "picture": "string",  "signature": "string",  "nic": "string",  "phoneNumber": "string",  "emailVerified": true,  "metadata": {    "property1": null,    "property2": null  }}

Obter utilizador

GET
/api/users/{id}

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo da resposta

OK

application/json
  1. response
id?string
name?string
username?string
email*string
Formatoemail
Comprimento1 <= length
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
picture?string
signature?string
nic?string
Comprimento0 <= length <= 13
phoneNumber?string
Padrão^\+[1-9]\d{1,14}$
emailVerified?boolean
metadata?
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string'
{  "id": "string",  "name": "string",  "username": "string",  "email": "user@example.com",  "status": "ACTIVE",  "picture": "string",  "signature": "string",  "nic": "string",  "phoneNumber": "string",  "emailVerified": true,  "metadata": {    "property1": null,    "property2": null  }}

Atualizar utilizador

PUT
/api/users/{id}

Permissão: igrp.users.update.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo do pedido

application/json
  1. body
id?string
name?string
username?string
email*string
Formatoemail
Comprimento1 <= length
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
picture?string
signature?string
nic?string
Comprimento0 <= length <= 13
phoneNumber?string
Padrão^\+[1-9]\d{1,14}$
emailVerified?boolean
metadata?

Corpo da resposta

OK

application/json
  1. response
id?string
name?string
username?string
email*string
Formatoemail
Comprimento1 <= length
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
picture?string
signature?string
nic?string
Comprimento0 <= length <= 13
phoneNumber?string
Padrão^\+[1-9]\d{1,14}$
emailVerified?boolean
metadata?
curl -X PUT 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string' \  -H 'Content-Type: application/json' \  -d '{  "email": "user@example.com"}'
{  "id": "string",  "name": "string",  "username": "string",  "email": "user@example.com",  "status": "ACTIVE",  "picture": "string",  "signature": "string",  "nic": "string",  "phoneNumber": "string",  "emailVerified": true,  "metadata": {    "property1": null,    "property2": null  }}

Mudar o estado do utilizador

PUT
/api/users/{id}/status

Permissão: igrp.users.manage.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Parâmetros de query

value*string

Corpo da resposta

OK

application/json
  1. response
id?string
name?string
username?string
email*string
Formatoemail
Comprimento1 <= length
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
picture?string
signature?string
nic?string
Comprimento0 <= length <= 13
phoneNumber?string
Padrão^\+[1-9]\d{1,14}$
emailVerified?boolean
metadata?
curl -X PUT 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/status?value=string'
{  "id": "string",  "name": "string",  "username": "string",  "email": "user@example.com",  "status": "ACTIVE",  "picture": "string",  "signature": "string",  "nic": "string",  "phoneNumber": "string",  "emailVerified": true,  "metadata": {    "property1": null,    "property2": null  }}

Obter metadados do utilizador

GET
/api/users/{id}/metadata

Metadados livres (JSON) do utilizador. O servidor de autorização usa-os para enriquecer o token.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo da resposta

OK

application/json
  1. response
userId?string
metadata?
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/metadata'
{  "userId": "string",  "metadata": {    "property1": null,    "property2": null  }}

Substituir metadados do utilizador

PUT
/api/users/{id}/metadata

Substitui o JSON de metadados. Usado por operadores e pelos fluxos de federação OAuth.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo do pedido

application/json
  1. body
metadata*

Corpo da resposta

OK

application/json
  1. response
userId?string
metadata?
curl -X PUT 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/metadata' \  -H 'Content-Type: application/json' \  -d '{  "metadata": {    "property1": null,    "property2": null  }}'
{  "userId": "string",  "metadata": {    "property1": null,    "property2": null  }}

Departamentos do utilizador

GET
/api/users/{id}/departments

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Parâmetros de query

departmentCode?string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code*string
Padrão^[A-Za-z0-9_-]+$
Comprimento1 <= length
name*string
Comprimento1 <= length
description?string
status?string
Valor em"ACTIVE""INACTIVE""DELETED"
icon?string
parentCode?string
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/departments'
{  "id": 0,  "code": "string",  "name": "string",  "description": "string",  "status": "ACTIVE",  "icon": "string",  "parentCode": "string"}

Perfis do utilizador

GET
/api/users/{id}/roles

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code*string
Padrão^[A-Za-z0-9_.-]+$
Comprimento0 <= length <= 255
name*string
Comprimento1 <= length
description?string
Comprimento0 <= length <= 255
departmentCode?string
parentCode?string
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
icon?string
expiresAt?string
Formatodate-time
permissions?array<string>
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/roles'
{  "id": 0,  "code": "string",  "name": "string",  "description": "string",  "departmentCode": "string",  "parentCode": "string",  "status": "ACTIVE",  "icon": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "permissions": [    "string"  ]}
GET
/api/users/{id}/departments/{departmentCode}/roles

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string
departmentCode*string

Parâmetros de query

roleCode?string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code*string
Padrão^[A-Za-z0-9_.-]+$
Comprimento0 <= length <= 255
name*string
Comprimento1 <= length
description?string
Comprimento0 <= length <= 255
departmentCode?string
parentCode?string
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
icon?string
expiresAt?string
Formatodate-time
permissions?array<string>
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/departments/string/roles'
{  "id": 0,  "code": "string",  "name": "string",  "description": "string",  "departmentCode": "string",  "parentCode": "string",  "status": "ACTIVE",  "icon": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "permissions": [    "string"  ]}

Atribuir perfis ao utilizador

POST
/api/users/{id}/departments/{departmentCode}/roles

Permissão: igrp.users.manage.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string
departmentCode*string

Corpo do pedido

application/json
  1. body
roles*array<string>
Itens1 <= items
expiresAt?string
Formatodate-time

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code*string
Padrão^[A-Za-z0-9_.-]+$
Comprimento0 <= length <= 255
name*string
Comprimento1 <= length
description?string
Comprimento0 <= length <= 255
departmentCode?string
parentCode?string
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
icon?string
expiresAt?string
Formatodate-time
permissions?array<string>
curl -X POST 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/departments/string/roles' \  -H 'Content-Type: application/json' \  -d '{  "roles": [    "string"  ]}'
{  "id": 0,  "code": "string",  "name": "string",  "description": "string",  "departmentCode": "string",  "parentCode": "string",  "status": "ACTIVE",  "icon": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "permissions": [    "string"  ]}

Retirar perfis ao utilizador

DELETE
/api/users/{id}/departments/{departmentCode}/roles

Permissão: igrp.users.manage.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string
departmentCode*string

Corpo do pedido

application/json
  1. body
[index: integer]?string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code*string
Padrão^[A-Za-z0-9_.-]+$
Comprimento0 <= length <= 255
name*string
Comprimento1 <= length
description?string
Comprimento0 <= length <= 255
departmentCode?string
parentCode?string
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
icon?string
expiresAt?string
Formatodate-time
permissions?array<string>
curl -X DELETE 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/departments/string/roles' \  -H 'Content-Type: application/json' \  -d '[  "string"]'
{  "id": 0,  "code": "string",  "name": "string",  "description": "string",  "departmentCode": "string",  "parentCode": "string",  "status": "ACTIVE",  "icon": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "permissions": [    "string"  ]}

Perfil ativo do utilizador

GET
/api/users/{id}/roles/active

Permissão: igrp.users.manage.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo da resposta

OK

application/json
  1. response
roleCode?string
departmentCode?string
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/roles/active'
{  "roleCode": "string",  "departmentCode": "string"}

Mudar o perfil ativo do utilizador

POST
/api/users/{id}/roles/active

Permissão: igrp.users.manage. Revoga as sessões do utilizador: o token seguinte traz as permissões do novo perfil.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Corpo do pedido

application/json
  1. body
roleCode?string
departmentCode?string

Corpo da resposta

OK

application/json
  1. response
roleCode?string
departmentCode?string
curl -X POST 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/roles/active' \  -H 'Content-Type: application/json' \  -d '{}'
{  "roleCode": "string",  "departmentCode": "string"}

Permissões do utilizador

GET
/api/users/{id}/permissions

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Parâmetros de query

roleCode?string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
name*string
Padrão^[A-Za-z0-9._-]+$
Comprimento0 <= length <= 255
description?string
Comprimento0 <= length <= 255
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
departments?array<string>
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/permissions'
{  "id": 0,  "name": "string",  "description": "string",  "status": "ACTIVE",  "departments": [    "string"  ]}

Aplicações do utilizador

GET
/api/users/{id}/applications

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string

Parâmetros de query

applicationCode?string
applicationName?string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code*string
Padrão^[A-Za-z0-9_-]+$
Comprimento1 <= length
name*string
Comprimento0 <= length <= 255
description?string
Comprimento0 <= length <= 255
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
type*string
Valor em"EXTERNAL""INTERNAL""SYSTEM"
owner?string
Comprimento0 <= length <= 255
picture?string
Comprimento0 <= length <= 255
url?string
Formatouri
slug?string
Comprimento0 <= length <= 255
createdBy?string
createdDate?string
lastModifiedBy?string
lastModifiedDate?string
lastAccess?string
Formatodate-time
departments?array<string>
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/applications'
{  "id": 0,  "code": "string",  "name": "string",  "description": "string",  "status": "ACTIVE",  "type": "EXTERNAL",  "owner": "string",  "picture": "string",  "url": "http://example.com",  "slug": "string",  "createdBy": "string",  "createdDate": "string",  "lastModifiedBy": "string",  "lastModifiedDate": "string",  "lastAccess": "2019-08-24T14:15:22Z",  "departments": [    "string"  ]}
GET
/api/users/{id}/applications/{applicationCode}/menus

Permissão: igrp.users.view.

Autorização

bearerAuth
headerAutorizaçãoBearer <token>

JWT emitido pelo Access Management. Leva as permissões do perfil ativo em permissions e o departamento dele em org — ver o modelo de controlo de acesso.

Parâmetros de caminho

id*string
applicationCode*string

Parâmetros de query

menuCode?string

Corpo da resposta

OK

application/json
  1. response
id?integer
Formatoint32
code?string
name*string
Comprimento0 <= length <= 255
type?string
Valor em"SYSTEM_PAGE""MENU_PAGE""EXTERNAL_PAGE""FOLDER""GROUP"
position?integer
Formatoint32
icon?string
Comprimento0 <= length <= 255
status?string
Valor em"ACTIVE""TEMPORARY""INACTIVE""DELETED"
target?string
Comprimento0 <= length <= 50
url?string
Comprimento0 <= length <= 255
pageSlug?string
parentCode?string
applicationCode?string
createdBy?string
createdDate?string
lastModifiedBy?string
lastModifiedDate?string
roles?array<>
curl -X GET 'http://localhost:2575/gateway-api/igrp-access-management/api/users/string/applications/string/menus'
{  "id": 0,  "code": "string",  "name": "string",  "type": "SYSTEM_PAGE",  "position": 0,  "icon": "string",  "status": "ACTIVE",  "target": "string",  "url": "string",  "pageSlug": "string",  "parentCode": "string",  "applicationCode": "string",  "createdBy": "string",  "createdDate": "string",  "lastModifiedBy": "string",  "lastModifiedDate": "string",  "roles": [    {      "roleCode": "string",      "departmentCode": "string"    }  ]}
How is this guide?

Última atualização: