Insert excerpt

	_Banners
	_Banners
name	administration
nopanel	true

This page is for PhixFlow administrators who need to set up user accounts in PhixFlow. It describes the user settings. excerpt-include_admin_user_topic_admin_user_topicnopaneltrue

Overview

Each user who needs to log into PhixFlow must have a user account set up. In addition, user accounts are added to user groups to control their access to features, items and data in PhixFlow.

Administrators use the user properties to configure the user accounts. Users can manage their own password in the User Details window.

Types of PhixFlow User

There are three types of userusers, depending on whether you manage the user authentication and authorisation:

entirely in PhixFlow - local user
partly with an external login system - mixed user
entirely with an external login system - external user.

User Type	Authentication	Authorisation
local user	User logs in with a username and password maintained in PhixFlow.	Access is controlled by user groups assigned to the user in PhixFlow.
mixed user	User logs in using integration with Active DirectoryAD/ AAD via SAMLAccess is controlled by user groups assigned to the user in PhixFlow.	Authentication is provided by AD/ AAD; authorisation is provided by PhixFlow. In this case, you must create accounts with the same username in PhixFlow. However, you do not need to set any password.
external user	User logs in with integration with Active DirectoryAD/ AAD via SAML or integration with AD via LDAP.	Access is controlled by external user groups mapped to PhixFlow user groups on login

TipIf you use an external

login

system (Active Directory/SAML), you must create accounts with the same username in PhixFlow

.

However, you do not need to set any password.

For more information, see:

Users can view and change their own user account details from the

Insert excerpt

	_user_details
	_user_details
nopanel	true

icon window, available at the bottom right of a PhixFlow window; see User Details.

Panel

borderColor	#7da054
titleColor	white
titleBGColor	#7da054
borderStyle	solid
title	Sections on this page

Table of Contents

indent	12px
style	none

from the header bar

Insert excerpt

	_user_options
	_user_options
nopanel	true

; see User Details.

You can add individual users to user groups. Members of a user group have the privileges of their roles. The privileges provide members of a user group with access to PhixFlow features, modelling objects, display components, actions and applications. For information about how users, user groups, roles and privileges work together, see:

Managing

the List a role

a role with the privilege Administer Users, User Groups and Roles. See Roles.

Adding or Changing a User Account

To create or change a user account, in the repository scroll down to the

Insert excerpt

	_user_repo
	_user_repo
nopanel	true

section.

To change an existing user account, double-click on the name to open its property tab.

To add a new user account, right-click

Insert excerpt

	_user_repo
	_user_repo
nopanel	true

and select

Insert excerpt

	_

addadd

User Properties

standardsettingsstandardsettings

Some users need to run analysis on models that include database export. When the datasource has the option Use User credentials on export ticked, PhixFlow automatically logs into the database using the user's:

the Basic Settings → Login Name

and Basic Settings → Password. InfoSystem configuration

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Basic Settings

Field

Description

Login Name

Required. Enter a name with which the user will log into PhixFlow. Whatever capitalisation you use, PhixFlow treats the name as all lowercase.

If creating a mixed user the login name must match the name used for the external login provider.

First Name

Required. Enter the first name of the user. For external users, the first name is supplied by the authentication provider.

Last Name

Enter the last name of the user. For external users, the last name is supplied by the authentication provider.

Locale

Required. Select the user's country from the drop-down list.

Insert excerpt

System configuration that withFor users configured via active directory, enter an active directory domain

The drop-down list displays all external login domains for authentication only. These are configured in phixflow-login.xml.

The domain set here also affects the user list in the repository as follows:

PhixFlow lists users grouped by domain.
Changing the domain here also changes where the user is listed in the repository.
Dragging a user to a different domain in the repository also changes the domain set in this property.

User Type

Read-only. PhixFlow displays LOCAL, MIXED or EXTERNAL, depending on the configuration of the properties.

Organisation

Enter your organisation name. For external users

configured via active directory this is active directory

the authentication provider.

Password

Available for local users only. Enter the user's password.

Users can change their password:

in their Insert excerpt
_user_details
_user_details
nopanel true
; see User Details
here, if they have the privilege Administer Users, User Groups and Roles.

Password Policy

Required. Available for local users only.

Keep the default password policy, or select an alternative. PhixFlow checks that the password meets the requirements configured in the password policy. The default password policy is configured for the PhixFlow instance in System Configuration.

Default DashboardSelect a dashboard that PhixFlow will display when the user logs in.Default ApplicationSelect an application that PhixFlow will load when the user logs in. Users can override the default by specifying an alternative application in the URL that they use to access PhixFlow.Email Address

Enter an email address for the user.

For users configured via active directory, enter an active directory email. configured via active directory, enter an active directory phone numbertickedticked

tick
nopanel	true

to allow the user to log into PhixFlow.

You can only enable a user if the Password has been set.

Insert excerpt

	_check_box_untick
	_check_box_untick
nopanel	true

to disable a user account, so that the user cannot log into PhixFlow. When you disable a user account, PhixFlow does not check the account details, such as password

or security questionstickedtickednopaneltrue the account is unlocked and the user can log in. Insert excerpt_check_box_untick_check_box_untickSend Alerts by SMSPhixFlow models or applications may be configured to send SMS messages to users

tick
nopanel	true

indicates there have been too many login failures and PhixFlow has locked the account to prevent unauthorised access. Untick the check box to unlock the account. The permitted number of login failures is configured in the

password policy._check_box_tickedtickednopaneltrue to allow PhixFlow to send SMS alerts to this user's Phone Number. Insert excerpt_check_box_ to prevent PhixFlow from sending SMS alerts to this user.Send Alerts by Email

PhixFlow models or applications may be configured to send emails to users.

tickedticked to allow PhixFlow to send emails to this user's Email Address

indicates PhixFlow has disabled password reset for this user. Untick the check box to allow password reset. The permitted number of reset attempts is configured in the Password Policy.

Insert excerpt

	_check_box_untick
	_check_box_untick
nopanel	true

to prevent PhixFlow from sending emails to this usertickedticked

tick
nopanel	true

to open PhixFlow in

Insert excerpt

	_design_mode
	_design_mode
nopanel	true

for this user.

Insert excerpt

	_check_box_untick
	_check_box_untick
nopanel	true

to open PhixFlow in the default

Insert excerpt

	_app_mode
	_app_mode
nopanel	true

.

Show the Help Tab on Startup

The Help tab provides a link to

the PhixFlow help pages tickedticked

tick
nopanel	true

to open the Help tab on the right of the

Insert excerpt

	_design_mode
	_design_mode
nopanel	true

view when the user logs in. The user can:

either click X on the Help tab to close it during their session
or untick this box via their User Details, to prevent the Help tab from being displayed.

Insert excerpt

	_check_box_untick
	_check_box_untick
nopanel	true

to prevent the Help tab being opened at login.

Last Activity Time

Read-only. PhixFlow displays the most recent time that the user was active in PhixFlow.

User Groups

This section has a toolbar with standard buttons and Insert excerpt_user_group_user_groupnopaneltrue.

The grid contains a list of user groups to which this user belongs. To add a user group to the list:
Click
Insert excerpt
_user_group
_user_group
nopanel true
to list all the user groups in the repository.
Drag user groups into this list. This automatically adds the user to the user group.
To remove a user from a user group, use the toolbar button
Insert excerpt
_delete
_delete
nopanel true
.
For

Active Directory for details

Security Questions

This section is only available for local users. Enter 3 questions and answers. If a user needs to reset their password, PhixFlow asks one of the questions to verify the user's identity; see Password Reset.

FieldDescriptionQuestion 1

To configure security questions and answers:

Either enter the security question-answer pairs for the user

Or leave these fields blank and ask the user to set their own via their User Details. These property fields will be automatically updated.

Tip
You can save the user properties without specifying any of the security questions and answers. However, once you have added a question and answer for one, you must complete them all before saving the user properties.

Answer 1Question 2Answer 2Question 3Answer 3Last requested reset time

PhixFlow displays the date/time of the last password reset.

Current Reset Attempts

PhixFlow displays the number of failed password-reset attempts.

Export Password

Config Export Settings

This section relates to exported configurations. These are applications, packages or selected objects saved as zip files. You can move exported configurations between PhixFlow instances.

To ensure data security, PhixFlow can encrypt the files. PhixFlow saves the files in the download area for a limited time period; see Configuring the Download Area.

Use the following fields to set a default password for exported configurations.

Field	Description
Export Password Policy	By default, PhixFlow applies the Password Policy set in System Configuration

→ Export Password Not Set

Excerpt

name	ExportPasswordPolicy

Note

Users require an Export Password Policy to be able to download exports.

For external users, this is set by the External User Template when the user is created. If this is not set, the user will not have an Export Password Policy and will not be able to download exports.

Set Default Export Password

For user accounts with an empty Export Password, use this tick box to distinguish between passwords set as blank, or passwords not yet set.

Insert excerpt

	_check_box_

tickedticked not . , even if the password field is left empty.This field is available when Not Set is not

is ticked.

Enter a password with at least 6 characters.

Insert excerpt

	_check_password
	_check_password
nopanel	true

.

When the user downloads an exported configuration, the zip file is encrypted and this password is associated with it. The user can enter a different password.

Note
If you set a default password, you must tell the user what it is. The user must supply the same password when they import the configuration to another PhixFlow instance; see Using the Download Area.

Insert excerpt
_more_options
_more_options
nopanel true

Field	Description
Close	Closes the user tab.
Generate API Key	Generates an API Key to be used in API Authentication, see API Authentication and Secret Keys.
Send Password Reset	Sends a password reset email to the user.
Back	Goes back.
Forward	Goes forward.
Find in Repository	Finds the user in the Repository.
Hide All	Collapses all sections on the user tab.
Permanently Delete	Deletes the user.

Insert excerpt

	_audit
	_audit
nopanel	true

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page

Panel

borderColor	#00374F
titleColor	white
titleBGColor	#00374F
borderStyle	solid
title	Sections on this page

Table of Contents

maxLevel	3
indent	12px
style	none

Version	Old Version 48	New Version Current
Changes made by	Fiona Sargeant (Unlicensed)	Zoe Baldwin
Saved on	Feb 13, 2020	Oct 11, 2024

Page Comparison

Versions Compared

Key

Overview

Types of PhixFlow User

Adding or Changing a User Account

User Properties

Insert excerpt_property_tabs_property_tabsnamebasic-hnopaneltrue

Basic Settings

User Groups

Security Questions

Config Export Settings

Insert excerpt_more_options_more_optionsnopaneltrue

Live SearchspaceKey@selfadditionalnoneplaceholderSearch all help pagestypepage

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Insert excerpt
_more_options
_more_options
nopanel true

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page