(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

200
400

Content type

application/json

{ }

Register

Register a new device for a user

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

200
400
403

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

200
400
401

Content type

application/json

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

Request Approval

Approval listing

Get a list of requests that require approval by user

query Parameters

userName

required

string

Example: userName=maxl

header Parameters

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

Responses

Response samples

200
400
401

Content type

application/json

{"data": [{"requestedFor": [{"fullName": "Janet Liu",
"userId": "janetl"
}
],
"requestedBy": {"fullName": "Janet Liu",
"userId": "janetl"
},
"processInstanceId": "1027",
"createTime": "24/07/2020",
"workflowType": "requestAccess",
"taskId": "1083"
},
{"requestedFor": [{"fullName": "Janet Liu",
"userId": "janetl"
}
],
"requestedBy": {"fullName": "Janet Liu",
"userId": "janetl"
},
"processInstanceId": "1220",
"createTime": "30/07/2020",
"workflowType": "requestAccess",
"taskId": "1276"
},
{"requestedFor": [{"fullName": "Woo Beng Heng",
"userId": "benghengw"
}
],
"requestedBy": {"fullName": "Woo Beng Heng",
"userId": "benghengw"
},
"processInstanceId": "637",
"createTime": "29/05/2020",
"workflowType": "requestAccess",
"taskId": "693"
},
{"requestedFor": [{"fullName": "Daniel Chin",
"userId": "danielc"
}
],
"requestedBy": {"fullName": "Cindy Teo",
"userId": "cindyt"
},
"processInstanceId": "760",
"createTime": "03/06/2020",
"workflowType": "requestAccess",
"taskId": "816"
}
]
}

Approval single

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

200
400
401
404

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%