Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

...

Info
titleLocation

In provision - key configuration

You can change the values of the below variables to customize iterations, seeding, and the algorithm used to hash passwords.

NameTypeDescription

Example

hashIterationsintegerHashing iteration value used by SOAJS hasher to encrypt/compare passwords16
seedLengthintegerSeed length value used by SOAJS hasher to encrypt/compare passwords32

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
titleLocation

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.

NameTypeDescriptionExample
validateJoinbooleanThis configuration controllers the status of a user after joining. aka ('pendingJoin' : 'active')
 
true

3. Mail Configuration

Info
titleLocation

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
languagejs
titleSMTP Configuration in common fieldsIn provision
"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:

Image Added

with the following configuration content:

"urac" : {
Code Block
languagejs
titleEmail Content Configuration in URAC
mail
{ // to control the smtp configuration
      "from": 'me@localhost.com',
      "transport": {...}
}


Code Block
languagejs
titleURAC
{
  "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
titleLocation

In provision


URAC allows third party login via one of the below methods:

  1. 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.
  2. OpenAM login: SSO (Single Sign-On).
  3. 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)

SettingsCustom
pinConfiguration1234
model¹"mongo"

hashIterations

24

seedLength12

model¹: We currently only support mongo models.

...