(1.0.0)

Download OpenAPI specification:Download

Welle Proxy OpenAPI Documentation

IC Governor (Welle) is the next generation Access Review engine, which helps support enterprise IT security and regulatory compliance. Unlike traditional Identity Governance products, IC Governor (Welle) is light-weight in architecture. It has a responsive user interface and speedy in back-end remediation. You can manage the identity life-cycle in your organization in a secure and convenient portal.

Mobile

Login

User login by scanning mobile QR

Request Body schema: application/json

A JSON object containing request body information

hashCode	string
deviceId	string
location	string
version	string

Responses

Request samples

Payload

Content type

application/json

{"hashCode": "nxbczftzazpdjojz",
"deviceId": "94703EC2-0AAD-xxxxx-xxxxx-xxxxxxxxxx",
"location": "Singapore",
"version": "1.3"
}

Response samples

Content type

application/json

{ }

Register

Request Body schema: application/json

A JSON object containing request body information

notificationToken	string
nounce	string
deviceId	string
location	string
phoneType	string
version	string
hashCode	string

Responses

Request samples

Payload

Content type

application/json

{"notificationToken": "cwZBvGYYQG2mhZl73C06k5:APA91bGdOuVpcBwp7vfSRbb2YpvnzdAyAfJQBfecKQZMP-JLgYAkD3gg_kTuSqQyCyjzgnjuX7JiIbWDl11wlG7dQBVW049sxnM-G8XbFd_xxxxx_om1KBqwMf-xxxxx-VxTzxd5XKKd",
"nounce": "YqdrlsUyQupB+ZUqHXDMadgz0/otBmOoyYOo9QVB+fCqHM6TWnSUg7U88IIYQ5nZ0ZXEIlLaHCYz9xojHRxagw==",
"deviceId": "94703EC2-0AAD-xxxx-xxxx-xxxxxxxxxxxx",
"location": "Singapore",
"phoneType": "iOS/iPhone 7 Plus",
"version": "1.0.0",
"hashCode": "jomjffxakhalirle"
}

Response samples

Content type

application/json

{ }

Users

Get the user information based on linked device ID

Request Body schema: application/json

A JSON object containing request body information

deviceId	string
location	string
version	string

Responses

Request samples

Payload

Content type

application/json

{"deviceId": "94703EC2-0AAD-xxxxx-xxxxx-xxxxxxxxxx",
"location": "Singapore",
"version": "1.2"
}

Response samples

Content type

application/json

{"givenName": "Max Lee",
"roles": "manager",
"session-jwt": "{session-jwt}",
"userName": "maxl"
}

Request Approval

Approval

Get a request that requires approval

path Parameters

request-id

required

string

Example: 1276

request-id using taskId from Request Approval - Approval Listing API

header Parameters

Authorization required	string Example: Bearer {session-jwt}
deviceId required	string Example: 94703EC2-0AAD-xxxxx-xxxxx-xxxxxxxxxx

Responses

Response samples

Content type

application/json

{"suspensionState": 1,
"cachedElContext": null,
"parentTaskId": null,
"dueDate": null,
"_rev": "1",
"taskLocalVariables": { },
"description": null,
"activityInstanceVariables": { },
"delegationState": null,
"delegationStateString": null,
"eventName": null,
"revisionNext": 2,
"formProperties": [{"userName": "janetl"
},
{"changes": null
},
{"managerDecision": null
},
{"comment": null
}
],
"owner": null,
"processDefinitionId": "oneLevelAccessRequest:4:838",
"processInstanceId": "1027",
"variables": {"approvalCode": "uyLDAG1VXcwVyl/u6aQCH1MCo6JXfbyNKElp3Q5zaTjGvj2z5ERxjrKNlcEYWxg8",
"role": "[{\"reason\":\"Mobile team test\",\"appName\":\"SAP ECC\",\"roleName\":\"MAIN_IN_CHARGE_ROLE\",\"action\":\"ADD\"},{\"reason\":\"Mobile team test\",\"appName\":\"SAP ECC\",\"roleName\":\"PLM_ACC\",\"action\":\"ADD\"},{\"reason\":\"Mobile team test\",\"appName\":\"LDAPEndpoint\",\"roleName\":\"[LDAP] Standard Group\",\"action\":\"ADD\"},{\"reason\":\"Mobile team test\",\"appName\":\"LDAPEndpoint\",\"roleName\":\"[LDAP] Advance Group\",\"action\":\"ADD\"},{\"reason\":\"Mobile team test\",\"appName\":\"ADEndpoint\",\"roleName\":\"[AD] JIRA\",\"action\":\"ADD\"},{\"reason\":\"Mobile team test\",\"appName\":\"ADEndpoint\",\"roleName\":\"[AD] Internet Access\",\"action\":\"ADD\"},{\"reason\":\"Mobile team test\",\"appName\":\"Corporate Directory Server\",\"roleName\":\"Directory Administrators\",\"action\":\"ADD\"}]",
"queryParams": {"_queryFilter": "/userName eq \"janetl\""
},
"encryptedPayloadAsString": "{\"$crypto\":{\"type\":\"x-simple-encryption\",\"value\":{\"cipher\":\"AES/CBC/PKCS5Padding\",\"salt\":\"M6oD3TvKmEUKF1EznXPqfQ==\",\"data\":\"OzcvidJ326dFr6z8s8xlSBn01TYeMB9y4eMDsfzGKSwAl90SCqT+9hYQ4K/KdcsWVWuWWbMzNJ6si6xQwn+Gszx0M0f/v1YYSjSyqweUjjmzsPCGeq6wgfngLn5CRZqsUxX1/x0K7iQ0zeHumdzO7dc1uHTabVyfI3bRMgPHOj3qS312XIE9kEjTc6aXCgo3\",\"iv\":\"cRIvpXt7+ISKiEiMiGVdqw==\",\"key\":\"openidm-sym-default\",\"mac\":\"x95fyf9Lh9PfZuLY9HetLQ==\"}}}",
"encodedEncryptedPayload": "%7B%22%24crypto%22%3A%7B%22type%22%3A%22x-simple-encryption%22%2C%22value%22%3A%7B%22cipher%22%3A%22AES%2FCBC%2FPKCS5Padding%22%2C%22salt%22%3A%22M6oD3TvKmEUKF1EznXPqfQ%3D%3D%22%2C%22data%22%3A%22OzcvidJ326dFr6z8s8xlSBn01TYeMB9y4eMDsfzGKSwAl90SCqT%2B9hYQ4K%2FKdcsWVWuWWbMzNJ6si6xQwn%2BGszx0M0f%2Fv1YYSjSyqweUjjmzsPCGeq6wgfngLn5CRZqsUxX1%2Fx0K7iQ0zeHumdzO7dc1uHTabVyfI3bRMgPHOj3qS312XIE9kEjTc6aXCgo3%22%2C%22iv%22%3A%22cRIvpXt7%2BISKiEiMiGVdqw%3D%3D%22%2C%22key%22%3A%22openidm-sym-default%22%2C%22mac%22%3A%22x95fyf9Lh9PfZuLY9HetLQ%3D%3D%22%7D%7D%7D",
"approvers": "[{\"name\":\"Max Lee\",\"decision\":\"\",\"stage\":\"1\"}]",
"finalEncodedEncryptedPayload": "%257B%2522%2524crypto%2522%253A%257B%2522type%2522%253A%2522x-simple-encryption%2522%252C%2522value%2522%253A%257B%2522cipher%2522%253A%2522AES%252FCBC%252FPKCS5Padding%2522%252C%2522salt%2522%253A%2522M6oD3TvKmEUKF1EznXPqfQ%253D%253D%2522%252C%2522data%2522%253A%2522OzcvidJ326dFr6z8s8xlSBn01TYeMB9y4eMDsfzGKSwAl90SCqT%252B9hYQ4K%252FKdcsWVWuWWbMzNJ6si6xQwn%252BGszx0M0f%252Fv1YYSjSyqweUjjmzsPCGeq6wgfngLn5CRZqsUxX1%252Fx0K7iQ0zeHumdzO7dc1uHTabVyfI3bRMgPHOj3qS312XIE9kEjTc6aXCgo3%2522%252C%2522iv%2522%253A%2522cRIvpXt7%252BISKiEiMiGVdqw%253D%253D%2522%252C%2522key%2522%253A%2522openidm-sym-default%2522%252C%2522mac%2522%253A%2522x95fyf9Lh9PfZuLY9HetLQ%253D%253D%2522%257D%257D%257D",
"managerName": "Max Lee",
"finalApproveURL": "http://192.168.200.106:8080/welle/api/workflow/approve?payload=%257B%2522%2524crypto%2522%253A%257B%2522type%2522%253A%2522x-simple-encryption%2522%252C%2522value%2522%253A%257B%2522cipher%2522%253A%2522AES%252FCBC%252FPKCS5Padding%2522%252C%2522salt%2522%253A%2522S68RNnSXgZusp9syVHqIZQ%253D%253D%2522%252C%2522data%2522%253A%2522Ym1na8Tw4aAl744iJrWTz6hKhNP3R2SbG%252FFcjGKNV5%252FucMtgkAmeuPWUMTq9W3IpocJoBZo5AE%252FH2OEG%252F4f9fmTXYldEphvki7uPhuf9WnhAvB5EdJOZlAp6r8MAB5xXWba5CXMlpdVkCEI7qAOeeWAAWAl36YskSE0tpgKi2gA1vL1vsxDBQX3dmfhiNx6b%2522%252C%2522iv%2522%253A%2522so2A0Ym8yeyKFjEPhDRhdA%253D%253D%2522%252C%2522key%2522%253A%2522openidm-sym-default%2522%252C%2522mac%2522%253A%25224WGILVigCOBxBH29h4b05w%253D%253D%2522%257D%257D%257D",
"startUserId": "janetl",
"rejectCode": "YXnKiqjtFoc4lCbP3NxKIB3IV3vMWqLQ8a5RLmo3xnZcu8nmSVpnFiQZ+dLTFFAv",
"payload": {"code": "YXnKiqjtFoc4lCbP3NxKIB3IV3vMWqLQ8a5RLmo3xnZcu8nmSVpnFiQZ+dLTFFAv",
"approverId": "maxl",
"user": "8d72fded-9384-46ba-8c48-03606737bcc3"
},
"emailApprovalParams": {"subject": "[IDM] Request for Access - Approval Required",
"from": "[email protected]",
"to": "[email protected]",
"type": "text/html",
"body": "<html><body>Dear Max Lee, <br/><br/>Requester, Janet Liu (janetl), raised a request for your approval. <br/><br/>Please login to the portal to approve and reject it. <br/><br/>Thank you</body></html>"
},
"requesterName": "Janet Liu",
"finalRejectURL": "http://192.168.200.106:8080/welle/api/workflow/reject?payload=%257B%2522%2524crypto%2522%253A%257B%2522type%2522%253A%2522x-simple-encryption%2522%252C%2522value%2522%253A%257B%2522cipher%2522%253A%2522AES%252FCBC%252FPKCS5Padding%2522%252C%2522salt%2522%253A%2522M6oD3TvKmEUKF1EznXPqfQ%253D%253D%2522%252C%2522data%2522%253A%2522OzcvidJ326dFr6z8s8xlSBn01TYeMB9y4eMDsfzGKSwAl90SCqT%252B9hYQ4K%252FKdcsWVWuWWbMzNJ6si6xQwn%252BGszx0M0f%252Fv1YYSjSyqweUjjmzsPCGeq6wgfngLn5CRZqsUxX1%252Fx0K7iQ0zeHumdzO7dc1uHTabVyfI3bRMgPHOj3qS312XIE9kEjTc6aXCgo3%2522%252C%2522iv%2522%253A%2522cRIvpXt7%252BISKiEiMiGVdqw%253D%253D%2522%252C%2522key%2522%253A%2522openidm-sym-default%2522%252C%2522mac%2522%253A%2522x95fyf9Lh9PfZuLY9HetLQ%253D%253D%2522%257D%257D%257D",
"workflowType": "requestAccess",
"changesObject": "[[action:ADD, appName:SAP ECC, reason:Mobile team test, roleName:MAIN_IN_CHARGE_ROLE], [action:ADD, appName:SAP ECC, reason:Mobile team test, roleName:PLM_ACC], [action:ADD, appName:LDAPEndpoint, reason:Mobile team test, roleName:[LDAP] Standard Group], [action:ADD, appName:LDAPEndpoint, reason:Mobile team test, roleName:[LDAP] Advance Group], [action:ADD, appName:ADEndpoint, reason:Mobile team test, roleName:[AD] JIRA], [action:ADD, appName:ADEndpoint, reason:Mobile team test, roleName:[AD] Internet Access], [action:ADD, appName:Corporate Directory Server, reason:Mobile team test, roleName:Directory Administrators]]",
"rejectEndpoint": "http://192.168.200.106:8080/welle/api/workflow/reject",
"encryptedPayload": {"$crypto": {"type": "x-simple-encryption",
"value": {"cipher": "AES/CBC/PKCS5Padding",
"salt": "M6oD3TvKmEUKF1EznXPqfQ==",
"data": "OzcvidJ326dFr6z8s8xlSBn01TYeMB9y4eMDsfzGKSwAl90SCqT+9hYQ4K/KdcsWVWuWWbMzNJ6si6xQwn+Gszx0M0f/v1YYSjSyqweUjjmzsPCGeq6wgfngLn5CRZqsUxX1/x0K7iQ0zeHumdzO7dc1uHTabVyfI3bRMgPHOj3qS312XIE9kEjTc6aXCgo3",
"iv": "cRIvpXt7+ISKiEiMiGVdqw==",
"key": "openidm-sym-default",
"mac": "x95fyf9Lh9PfZuLY9HetLQ=="
}
}
},
"requesterMail": "[email protected]",
"requesterId": "8d72fded-9384-46ba-8c48-03606737bcc3",
"userFullName": "Janet Liu",
"userManager": ["maxl"
],
"enduserObject": {"totalPagedResults": -1,
"result": [{"preferences": {"marketing": false,
"updates": false
},
"telephoneNumber": "+6586500305",
"mail": "[email protected]",
"devices": [{"location": "Singapore",
"deviceId": "A41B021C-DF3C-4532-AE99-8387BA3F3988"
},
{"location": "United States",
"deviceId": "EF7D25A9-6434-4DE3-B306-EB8D3924DE56"
},
{"location": "Indonesia",
"deviceId": "2d65edc7cd525dd6"
},
{"location": "Indonesia",
"deviceId": "5a3d491db0ede799"
},
{"location": "Test",
"deviceId": "339BCE0E-D7E0-4D7D-A889-9959676412239"
},
{"lastLoginTimestamp": "2020-07-24 11:24:03",
"location": "Indonesia",
"deviceId": "93c449b6e622dd9e"
<