Introduction
URAC micro-service V3 configuration variables that are needed and can be customized
1. Password generation configuration
| Info | ||
|---|---|---|
| ||
In create a custom registry - urac |
You can change the values of the below variables to customize iterations, seeding, and the algorithm used to hash passwords.
| Name | Type | Description | Example |
|---|---|---|---|
| hashIterations | integer | Hashing iteration value used by SOAJS hasher to encrypt/compare passwords | 12 |
optionalAlgorithm | string | Password Hashing algorithm name. "aes256" or "des". You can go to List of Crypto Algorithms to find the name of the algorithm that you can use. You do not need to set this configuration if you do not want to specify an algorithm | aes256 |
More information can be found in the Complete Example
2. Join & Membership
| Info | ||
|---|---|---|
| ||
In Add to provision - key configuration In Create custom registry - urac |
You can change the values of the below variables to customize if you want the user to validate their email once they join or not.
| Name | Type | Description | Example | ||
|---|---|---|---|---|---|
| validateJoin | Boolean | This configuration controllers the status of a user after joining. aka ('pendingJoin' : 'active') | true | ||
| membership | Object | This configuration allows you to configure different type of membership that can be set while joining to drive different user configuration like group groups (make sure the group groups is available) we only support . Should be an array of 1 group for nowgroups. |
|
3. Mail Configuration
| Info | ||
|---|---|---|
| ||
In Add to provision - key configuration In Create custom registry - mail & urac |
...
More information about Variables used, custom data fields used in "content", and examples of the configuration can be found under Mail Configuration
Examples: In provision
| Code Block | ||||
|---|---|---|---|---|
| ||||
"commonFields" : {
"mail": { // to control the smtp configuration
"from": 'me@localhost.com',
"transport": {...}
},
"sms":{
"from": '16170000000',
"twilio": {
"accountSid": "WWWW",
"authToken": "WWWW"
}
}
},
"urac" : {
"linkslink": {...}, // this object to control the links in the emails
"mail": { // this object to control the content of the emails
"join": {...}, // Join - mail content configuration
"forgotPassword": {...}, // Forgot password mail - content configuration
"addUser": {...}, // Add User - mail content configuration
"changeUserStatus": {...}, // Change User Status - mail content configuration
"changeEmail": {...} // Change Email - mail content configuration
},
"sms": {
"inviteToJoin": {...}
}
} |
Examples: In custom registry
You should create to entries under custom registry (one for mail, one for urac, and one for uracsms) as follow:
with the following configuration content:
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"linkslink": {...}, // this object to control the links in the emails
"addUser": "...",
"changeEmail": "...",
"forgotPassword": "...",
"inviteToJoin": "...",
"join": "..."
},
"mail": { // this object to control the content of the emails
"addUser": {...},
"changeEmail": {...},
"changePin": {...},
"changeUserStatus": {...},
"forgotPassword": {...},
"invitePin": {...},
"join": {...},
"resetPin": {...}
"inviteToJoin": {...}
},
"sms": {
"inviteToJoin": {...}
}
} |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{ // to control the smtp configuration
"from": '16170000000',
"twilio": {...}
} |
4. Mail token configuration
| Info | ||
|---|---|---|
| ||
In Add to provision - key configuration In Create custom registry - urac |
The URAC sends verification mail with links containing token with expiration date.
...
7. Roaming among main tenants
| Info | ||
|---|---|---|
| ||
In Create custom registry - urac |
You can change the values of the below variable to turn on roaming among main tenants. Either you set masterCode or your set dbCodes.
| Name | Type | Description | Example | |||||
|---|---|---|---|---|---|---|---|---|
| masterCode | String | consolidate all main tenants' user under one master db and create roaming capabilities among them by invitation only. Also this will consolidate all tenants groups under one master db. | "TTTT" | |||||
| autoRoaming | Object | To automatically allow roaming among main tenants |
| |||||
| dbCodes | Object | To consolidate |
designated main |
tenants' users and create roaming capabilities among them by invitation only. for example we have tenant TTT turning on roaming with tCODE1 and tCODE2 |
|
|
|
|