-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #374 from bcgov/ssoteam-1291
docs: update mappers
- Loading branch information
Showing
3 changed files
with
99 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,11 +1,107 @@ | ||
![IDP Mappers](./img/idp-mappers.jpg) | ||
See below for the IDP specific claims available. For all IDPs the **Keycloak Generated Preferred Username** will be a unique identifier with a reference to the idp, e.g. `<user-guid>@idp-alias`. | ||
|
||
![Github IDP Mappers](./img/gh-idp-mappers.jpg) | ||
## IDIR | ||
|
||
| Description | Standard Realm - Claim Name | | ||
| ------------------------------------- | ----------------------------- | | ||
| First Name | given_name | | ||
| Last Name | family_name | | ||
| Email | email | | ||
| Display Name | display_name | | ||
| Display Name | name | | ||
| IDIR Username | idir_username | | ||
| IDIR User GUID | idir_user_guid | | ||
| Keycloak Generated Preferred Username | preferred_username | | ||
|
||
* Any other attribute can be fetched by the app itself using [IDIM Web Services](https://sminfo.gov.bc.ca/) | ||
|
||
## IDIR MFA | ||
|
||
| Description | Standard Realm - Claim Name | | ||
| ------------------------------------- | ----------------------------- | | ||
| First Name | given_name | | ||
| Last Name | family_name | | ||
| Email | email | | ||
| Email | user_principal_name | | ||
| Display Name | display_name | | ||
| Display Name | name | | ||
| IDIR Username | idir_username | | ||
| IDIR User GUID | idir_user_guid | | ||
| Keycloak Generated Preferred Username | preferred_username | | ||
|
||
## Basic BCeID | ||
|
||
| User Property/Attribute | Standard Realm - Claim Name | | ||
| ------------------------------------- | ----------------------------- | | ||
| Email | email | | ||
| Display Name | display_name | | ||
| Display Name | given_name | | ||
| Display Name | name | | ||
| BCeID Username | bceid_username | | ||
| BCeID User GUID | bceid_user_guid | | ||
| Keycloak Generated Preferred Username | preferred_username | | ||
|
||
## Business BCeID | ||
|
||
| User Property/Attribute | Standard Realm - Claim Name | | ||
| ------------------------------------- | ----------------------------- | | ||
| Email | email | | ||
| Display Name | display_name | | ||
| Display Name | given_name | | ||
| Display Name | name | | ||
| BCeID Username | bceid_username | | ||
| BCeID User GUID | bceid_user_guid | | ||
| Keycloak Generated Preferred Username | preferred_username | | ||
| BCeID Business Guid | bceid_business_guid | | ||
| BCeID Business Name | bceid_business_name | | ||
|
||
## BCeID Both | ||
|
||
See above for claims depending on BCeID type selected by end user. | ||
|
||
## GitHub Public | ||
|
||
| User Property/Attribute | Standard Realm - Claim Name | | ||
| ------------------------------------- | ---------------------------------------- | | ||
| Email | email | | ||
| Display Name | display_name | | ||
| Display Name | name | | ||
| Display Name | given_name | | ||
| GitHub ID | github_id | | ||
| Keycloak Generated Preferred Username | preferred_username=`{{id}}@githubpublic` | | ||
| GitHub Username | github_username | | ||
| BCGov Github Membership | org_verified | | ||
| BCGov Github Orgs | orgs | | ||
|
||
## GitHub BCGov | ||
|
||
| User Property/Attribute | Standard Realm - Claim Name | | ||
| ------------------------------------- | ---------------------------------------- | | ||
| Email | email | | ||
| Display Name | display_name | | ||
| Display Name | name | | ||
| Display Name | given_name | | ||
| GitHub ID | github_id | | ||
| Keycloak Generated Preferred Username | preferred_username | | ||
| GitHub Username | github_username | | ||
| BCGov Github Membership | org_verified | | ||
| BCGov Github Orgs | orgs | | ||
|
||
## BC Services Card | ||
|
||
| User Property/Attribute | Standard Realm - Claim Name | | ||
| ------------------------------------- | --------------------------------------- | | ||
| Keycloak Generated Preferred Username | preferred_username=`{{sub}}@<idp-name>` | | ||
|
||
**Note:** Clients can request additional claims when creating their client in the CSS App. See [here](https://id.gov.bc.ca/oauth2/claim-types) for an up-to-date list of available claims. The BCSC sub will not be available for selection in the app, however the received token's sub or preferred_username claim can be used as an identifier. | ||
|
||
## Digital Credential | ||
|
||
[Another way to view this from a developer perspective](https://bcgov.github.io/sso-docs/advanced/identity-mappers) | ||
| User Property/Attribute | Standard Realm - Claim Name | | ||
| ----------------------------------------- | ---------------------------------------------- | | ||
| Keycloak Generated Preferred Username | preferred_username | | ||
| Digital Credential Content (JSON) | vc_presented_attributes | | ||
| The Presentation Request Configuration ID | pres_req_conf_id | | ||
|
||
## Playground | ||
[Try our playground to see what comes in the payload with your client integration](https://bcgov.github.io/keycloak-example-apps/) |
Binary file not shown.
Binary file not shown.