Versions Compared

Key

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


Section


Column

frevvo is a multi-tenant application. Tenants allow you to segregate groups of users and roles. Users from one tenant cannot access users in any other tenant. Note: this does not apply to public forms/workflows which do not require login access to a tenant.

The frevvo In-house superuser admin can create as many tenants on your form server as needed. Once the superuser admin creates the tenant, the tenant admin user can then login to manage the tenant, configure LDAP, add users & roles, etc. See the Admin Home Page for differences between the superuser admin and tenant admin. 

Info

frevvo trial tenants in the cloud are initially configured with the frevvo Default security Manager. Once you have purchased your frevvo license, you can switch the Security Manager of your tenant and retain existing forms/workflows, users, roles and submissions.

Tenants using the Default Security Manager can be migrated to:

  • Default Security Manager → LDAP
  • Default Security Manager → SAML  
  • Default Security Manager →  Azure SAML

Tenants using the LDAP Security Manager can migrate to:

  • LDAP → SAML
  • LDAP → Azure SAML

Contact us to purchase or change your security manager.



Column
width35%

On this page:

Table of Contents
maxLevel2


...

  • Security Manager Class: Select a Security Manager Option from the following choices: 

    Section


    Column


    Column
    1. Frevvo Default Security Manager (FSM) - frevvo is responsible for authentication/authorization and managing users/roles. This is the default option. Your tenant will be created with this security manager if no other choice is selected. 
    2. LDAP Active Directory Security Manager (LDAPSM) - The user is authenticated outside frevvo. Typically, SSO or frevvo performs the authentication using LDAP directly.
    3. SAML Security Manager - This security manager allows the  exchange of authentication and authorization data between an identity provider of your choice (ex:Shiboleth) and a service provider (frevvo). SSO is supported. Although this security manager can be used on-premise it is primarily meant for cloud tenants who use LDAP but do not want to expose it over the internet.
    4. Azure SAML Security Manager - Allows the on-premises AD to be exposed to the cloud via synchronization with Azure AD. Uses the graph API to access users and groups from AD. SAML is used for authentication only, providing single sign on.
    5. Delegating Security Manager - used for OEM implementations of frevvo



  • Tenant ID - Enter the tenant Id in this field - The tenant id can contain characters, numbers, dot(.), hyphen (-) and the underscore. It cannot start with a number. A common practice is to use your domain name for the tenant id.

  • Tenant Name - Enter the name of the new tenant.
  • Tenant Description - Enter a description for the new tenant.
  • Password Strength - This feature only applies to the Default Security Manager. Tenant admins can set password strength requirements on the Create Tenant or Edit Tenant screens. There are four password strength options (Fair, Good, Strong, Very Strong) or the field can be left blank if you do not want to enforce password strength. Leaving this blank will still require minimum password length of 8 characters. When you change the password strength requirement, users whose passwords do not comply will automatically be prompted to change their password on their next login.
  • Max Concurrent Users - Leave this field blank if you do not want to set a maximum number of concurrent users. Concurrent Users are users that are logged into frevvo simultaneously. You will not see this field if your tenant is configured for the LDAP, SAML or AzureSecurity Managers.
  • Admin User Id - This is the tenant admin id. It can contain characters, numbers and the underscore. It cannot start with a number. The maximum length is 16 characters. This account is used as the built-in admin if you are using the LDAP, SAML or AzureSecurity Managers.
  • Admin User Password - This is the tenant admin password. Notice the text will appear as bullets as you type.
  • Reenter the Admin User Password - Reenter  the tenant admin password. frevvo will display an error message, "Invalid Value" if what you type in this field does not match the contents of the Admin User Password field. This is one way to change the password for the built-in admin if you are using the LDAP, SAML or Azure Security Managers.
  • Change password on next login - Tenant Admins can expire passwords by checking this field. The tenant admin will be prompted to change their password the next time they login.
  • Admin User Email Address - Enter the Email Address for the user id specified in the Admin User Id (built-in admin) field. The tenant admin receives an email with a link if they use the frevvo Forget Password? feature to reset their password.

Rename Tenant

You may have a need to change a tenant id; for example, if your business name changes and you would like your frevvo tenant id to match your new business or domain name. For On Premise customers, the server admin (admin@d) can change a tenant id using the Rename Tenant process. Cloud customers who want to rename their tenant should contact their account manager or support@frevvo.com to initiate this process.

Warning

This operation should be uncommon. The rename tenant process will run in the background and link all the data belonging to the old tenant id with the new tenant id. This can take up to 24 hours. Please ensure no users are logged into that tenant. Once completed, refresh all searchable items for the new tenant.

First, ensure no users are logged into the tenant, and will not attempt to log in while the process runs.

Image Removed

This opens the Rename Tenant page. You will see past processes and their status.

Image Removed

Click the green plus icon to start a new Rename Tenant process. Enter part of the tenant ID and click Search. 

Image Removed

Select the tenant id you want to rename. 

Image Removed

Enter the new tenant ID, and confirm that you want to rename the tenant.

...

  • .

Set Up the Business Calendar for your tenant

...

Configuring the SharePoint Connector

Store submissions and metadata on a registered SharePoint website using the frevvo SharePoint Connector and wizard. The configuration information is discussed in the SharePoint Connector topic

Configuring the LDAP/Active Directory Security Manager

Creating/editing the LDAP tenant is performed by the superuser (on-premise) or the tenant admin (cloud). Refer to this documentation for configuration details and here for some troubleshooting tips. 

Configuring the SAML Security Manager

Creating/editing the SAML tenant is performed by the superuser (on-premise) or the tenant admin (cloud). Refer to the SAML Security Manager topic for the details.

Configuring the Azure SAML Security Manager

...

  • Admin User Id - This is the tenant admin id. It can contain characters, numbers and the underscore. It cannot start with a number. The maximum length is 16 characters. This account is used as the built-in admin if you are using the LDAP, SAML or Azure Security Managers.
  • Admin User Password - This is the tenant admin password. Notice the text will appear as bullets as you type.
  • Reenter the Admin User Password - Reenter  the tenant admin password. frevvo will display an error message, "Invalid Value" if what you type in this field does not match the contents of the Admin User Password field. This is one way to change the password for the built-in admin if you are using the LDAP, SAML or Azure Security Managers.
  • Change password on next login - Tenant Admins can expire passwords by checking this field. The tenant admin will be prompted to change their password the next time they login.
  • Enter the Email Address for the user id specified in the Admin User Id (built-in admin) field. The tenant admin receives an email with a link if they use the frevvoForget Password? feature to reset their password.

Built-in admin for LDAP, Azure and SAML Security Manager tenants

A Tenant admin can login directly to frevvo or login with a user id who has been given tenant admin permissions in your Active Directory. Tenants using the LDAP(s) Security Manager now have the ability to configure a built-in admin account. This was not possible for this Security Manager in previous releases.

...

Definitions of Password Strength:

  • none - uses system default, enforces a minimum password of 8 characters
  • Fair - very guessable: protection from throttled online attacks. (guesses < 10^6) Strength meter will indicate "Very weak."
  • Good - somewhat guessable: protection from unthrottled online attacks. (guesses < 10^8) Strength meter will indicate "Weak."
  • Strong - safely unguessable: moderate protection from offline slow-hash scenario. (guesses < 10^10)
  • Very Strong - very unguessable: strong protection from offline slow-hash scenario. (guesses >= 10^10)

A user creating or resetting their password will be required to meet the password strength specified by the tenant admin. Password strength is indicated as the user types by a Password Strength Meter visible below the entry. There are no specific length or character requirements, but the meter will detect the strength of the password based on use of uncommon words or phrases and unpredictable use of capitalization, numbers and special characters. Helpful suggestions appear to prompt the user towards a stronger password. Password length is limited to 100 characters and an error message will appear if user attempts to enter more than 100 characters. Users cannot use their old password or a temporary password as the new password. Here are screenshots of what a user might see if the Tenant Password Strength is set to "Strong." Strong and Very Strong passwords use uncommon words or phrases and unpredictable use of capitalization, numbers and special characters.

...