Introduction
...
Info | ||
---|---|---|
| ||
In provision - key configuration |
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 | 16 |
seedLength | integer | Seed length value used by SOAJS hasher to encrypt/compare passwords | 32 |
optionalAlgorithm | string | Password Hashing algorithm name | "aes-128-cbc-hmac-sha256" or "des". You can go to List of Crypto Algorithms to find the name of the algorithm that you can use. |
2.
...
Join
Info | ||
---|---|---|
| ||
In provision |
URAC allows third party login via one of the below methods:
...
- key configuration |
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 |
3. Mail Configuration
Info | ||
---|---|---|
| ||
In provision || - key configuration In custom registry |
Mail configuration can be found under two configuration objects:
...
More information about Variables used, custom data fields used in "content", and examples of the configuration can be found under Mail Notification Configuration
Examples:
...
In provision
Code Block | ||||
---|---|---|---|---|
| ||||
"commonFields" : { "mail": { // to control the smtp configuration "from": 'me@localhost.com', "transport": {...} } }, "urac" : { "links": {...}, // 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 } } |
Examples: In custom registry
You should create to entries under custom registry (one for mail and one for urac) as follow:
with the following configuration content:
Code Block | ||||||
---|---|---|---|---|---|---|
| "urac" : {
||||||
{ // to control the smtp configuration
"from": 'me@localhost.com',
"transport": {...}
} |
Code Block | ||||
---|---|---|---|---|
| ||||
{
"links": {...}, // 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
}
} |
...
Resources and database configuration and creation steps can be found under Data Configuration.
6. 3rd party login configuration
Info | ||
---|---|---|
| ||
In provision |
URAC allows third party login via one of the below methods:
- Passport Login: Define application keys for passport integration. Currently supporting Azure, Github, Twitter, Facebook, and Google. Got to the link for more information and an example of the configuration.
- OpenAM login: SSO (Single Sign-On).
- LDAP (Lightweight Directory Access Protocol) login: Active directory login.
...
Configuration priority and the default values
...
Name | Local Configuration (Default) config.js | Registry Configuration (Per Environment) req.soajs.registry | Tenant Configuration (Per Tenant Per Environment) | |
---|---|---|---|---|
Settings | Custom | |||
pinConfiguration | 1234 | ✓ | ✓ | |
model¹ | "mongo" | ✓ | ||
hashIterations | 24 | ✓ | ||
seedLength | 12 | ✓ |
model¹: We currently only support mongo models.
...