Naviga ID
Docs HomeInfomakerNaviga
  • Introduction
  • Release notes
  • Architecture
    • Authorization schema
  • Integrations
    • Customer Integration
      • Microsoft Azure
      • Google G Suite
      • Custom Identity Provider
      • Moving to a New Identity Provider
    • Service Integration
      • IMSG and headers
  • Services
    • Admin API
      • Routes
        • Health
        • Organizations
        • Permissions
        • Roles
        • Units
        • Services
        • Subjects
        • Organization applications
        • Internal applications
    • IMSG
      • Routes
        • Imsg-service
      • Environment variables
  • Shared modules
    • Http Test Server
      • HttpTestServer
    • Service Authorization Lib
      • Authorize
      • Errors
      • ExpressMiddleware
      • TokenUtils
      • Hapi plugin
      • ServiceAuthorizationError
      • AccessDenied
      • Unauthorized
      • ConfigError
  • Client Credentials
    • Managing Applications
    • Internal Naviga ID Docs
  • Access Token
    • Fetching and using Access Tokens
    • Validate Access Tokens
  • Local development
    • Local HTTPS support
  • Post Mortem
    • Broken backwards compatibility in access token service for client credentials, 20th Dec 2021
Powered by GitBook
On this page
  • /roles.get
  • /roles.list
  • /roles.listMappedGroups
  • /roles.assignToGroup
  • /roles.create
  • /roles.delete
  • /roles.mapPermission
  • /roles.setDescription
  • /roles.setName
  • /roles.setParentRole
  • /roles.unassignFromGroup
  • /roles.unmapPermission

Was this helpful?

Export as PDF
  1. Services
  2. Admin API
  3. Routes

Roles

/roles.get

GET https://admin-api.imid.infomaker.io/v1/roles.get

Get role by id

Query Parameters

Name
Type
Description

roleId

string

Role id

{
  "id": "Role id",
  "serviceId": "Service id",
  "name": "user",
  "description": "Description of speicific part xxx",
  "parentRoleId": "Role id",
  "updatedBySub": "infomaker_b8b9373b-a30d-459d-a44d-f270afb5e581"
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.list

GET https://admin-api.imid.infomaker.io/v1/roles.list

List roles

Path Parameters

Name
Type
Description

string

[
  {
    "id": "Role id",
    "serviceId": "Service id",
    "name": "user",
    "description": "Description of speicific part xxx",
    "parentRoleId": "Role id",
    "updatedBySub": "infomaker_b8b9373b-a30d-459d-a44d-f270afb5e581"
  }
]
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.listMappedGroups

GET https://admin-api.imid.infomaker.io/v1/roles.listMappedGroups

List all mapped groups by role id

Query Parameters

Name
Type
Description

roleId

string

Role id

organizationId

string

Organization id

[
  {
    "roleId": "Role id",
    "unitId": "Unit id",
    "organizationId": "Organization id",
    "group": "Auth team"
  }
]
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.assignToGroup

POST https://admin-api.imid.infomaker.io/v1/roles.assignToGroup

Add group to role mapping

Request Body

Name
Type
Description

roleId

string

Role id

organizationId

string

Organization id

group

string

Organization group name

unitId

string

Unit id

{
  "roleId": "Role id",
  "organizationId": "Organization id",
  "group": "Auth team",
  "unitId": "Unit id"
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.create

POST https://admin-api.imid.infomaker.io/v1/roles.create

Create role

Request Body

Name
Type
Description

serviceId

string

Service id

name

string

Service role name

parentRoleId

string

Role id

description

string

Description of speicific part xxx

{
  "id": "Role id",
  "serviceId": "Service id",
  "name": "user",
  "description": "Description of speicific part xxx",
  "permissions": []
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.delete

POST https://admin-api.imid.infomaker.io/v1/roles.delete

Delete role by id

Request Body

Name
Type
Description

roleId

string

Role id

""
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.mapPermission

POST https://admin-api.imid.infomaker.io/v1/roles.mapPermission

Map permissision to role

Request Body

Name
Type
Description

roleId

string

Role id

permissionId

string

Permission id

{
  "roleId": "Role id",
  "permissionId": "Permission id"
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.setDescription

POST https://admin-api.imid.infomaker.io/v1/roles.setDescription

Set role description by id

Request Body

Name
Type
Description

roleId

string

Role id

description

string

Description of speicific part xxx

{
  "description": "Description of speicific part xxx"
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.setName

POST https://admin-api.imid.infomaker.io/v1/roles.setName

Set role name by id

Request Body

Name
Type
Description

roleId

string

Role id

name

string

Service role name

{
  "name": "user"
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.setParentRole

POST https://admin-api.imid.infomaker.io/v1/roles.setParentRole

Set role parent role by id

Request Body

Name
Type
Description

roleId

string

Role id

parentRoleId

string

Role id

{
  "parentRoleId": "Role id"
}
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.unassignFromGroup

POST https://admin-api.imid.infomaker.io/v1/roles.unassignFromGroup

Delete group to role mapping

Request Body

Name
Type
Description

roleId

string

Role id

organizationId

string

Organization id

group

string

Organization group name

unitId

string

Unit id

""
"errors.api.BadRequestError"
"errors.api.InternalServerError"

/roles.unmapPermission

POST https://admin-api.imid.infomaker.io/v1/roles.unmapPermission

Unmap permission from role

Request Body

Name
Type
Description

roleId

string

Role id

permissionId

string

Permission id

""
"errors.api.BadRequestError"
"errors.api.InternalServerError"
PreviousPermissionsNextUnits

Last updated 4 years ago

Was this helpful?