Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

Introduction

URAC micro-service V3 configuration variables that are needed and can be customized 

1. Password generation variables

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. Passport Login variables

Define application keys for passport integration. Currently supporting Twitter, Facebook, and Google. For more information and an example of the configuration, go to Passport Login.

3. Mail Configuration variables

  1. Under common fields in order to be used in other microservices not only in URAC.
  2. Under URAC configuration in order to customize mail options to handle URAC requirements.

Examples:

Mail Configuration in Common Fields
"commonFields" : {
    "mail" : {
				// to control the smtp configuration
			}
}

"urac" : {
	// this object to control the links in the emails
	"links": {...}

	// this object to control the content of the emails
	"mail": {
		"join": {... //this is the join email content configuration}
		"forgotPassword": {... //}
	}
}

"mail": {
        "from": 'me@localhost.com',
    "transport": {
    "type": "sendmail",
    "options": {}
  }
}
Mail Configuration in URAC Config
"mail": { //urac mail options
  "join": {
    "subject": 'Welcome to SOAJS',
    "path": "./mail/urac/join.tmpl"
  },
  "forgotPassword": {
    "subject": 'Reset Your Password at SOAJS',
    "path": "./mail/urac/forgotPassword.tmpl"
  },
  "addUser": {
    "subject": 'Account Created at SOAJS',
    "path": "./mail/urac/addUser.tmpl"
  },
  "changeUserStatus": {
    "subject": "Account Status changed at SOAJS",
    //use custom HTML
    "content": "<p>Dear <b>{{ username }}</b>, <br />Your account status has changed to <b>{{ status }}</b> by the administrator on {{ ts|date('F jS, Y') }}.<br /><br /> Regards,<br/> SOAJS Team. </p>"
  },
  "changeEmail": {
    "subject": "Change Account Email at SOAJS",
    "path": "./mail/urac/changeEmail.tmpl"
  }
}

Variables used, custom data fields used in "content", more information, and examples of the configuration can be found under Mail Notification Configuration

4. Pin configuration variables

Pin configuration is made to add a second layer of authentication to URAC. For full information go to Pin Configuration


5. Registry configuration

Resources and database creation steps can be found under Database needed by URAC. More information can be found under the registry configuration layer below.

Configuration Layers and Levels

1. Default Configuration

Default Configuration layer That can be overridden by one of the below configuration layers.

2. Registry Configuration 

Table and links to examples 

Database needed by URAC


3. Tenant Configuration

Table and links to examples 

Link to Complete example 


Configuration priority and the default values

This table illustrates the configuration that can be overridden at a different layer of configuration 

Priority

Local → Registry → Tenant 

  1. Local Configuration
  2. Custom Registry
  3. Service Configuration (Tenant)



Name


Local Configuration (Default)

config.js

Registry Configuration (Per Environment)

req.soajs.registry


Tenant Configuration (Per Tenant Per Environment)

SettingsCustom
pinConfiguration
model¹

hashIterations



seedLength

model¹: We currently only support mongo models.

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.