Help The platform Import and SSO
Import people and set up SSO
On this page
What an import is for
An import brings the people and groups of a directory (Entra ID, LDAP / Active Directory, Google Workspace, Okta, Keycloak) into the organization and keeps them up to date, or those of a CSV file that you upload. LDAP and CSV do not allow SSO. Several imports are possible, for example one per site.
Only the organization administrator creates, edits, runs or deletes an import; the Manage people permission gives read-only access. What you need to prepare at the provider is in its article:
Connecting to the provider
Nothing enters the organization before the last step, Launch. Test connection saves nothing: after a successful test, click Save and continue.
- The secret (password, client secret, token or key) is never shown again. Left empty, it is kept.
- If you change another connection setting, re-enter the secret as well, otherwise saving is refused.
- If it fails, the message does not state the cause: check the settings and rights given in the provider’s article.
If your organization encrypts its data, the Bexxo Protected agent installed on your side queries the directory, not our servers. The vault must be unlocked to read or change the connection. The test and the group search go through the agent: with no answer after 10 minutes, check that it is running. A connection saved before encryption was switched on must be re-entered in full, including the secret.
Who is imported, with which data
Imported groups
Only the members of the selected groups are imported; with no selected group, the whole directory is. The search shows at most 50 groups: refine the text if yours does not appear.
If a selected group no longer exists in the directory, or if the selected groups have no members, the synchronization fails without importing anything.
Filters
Filters keep or exclude people or groups according to an attribute (department, account type…). Good to know:
- uppercase and lowercase are ignored;
- the AND or OR of a line links it to the result of the previous lines;
- In the list expects values separated by a semicolon, for example
Sales;Marketing; - Different, Does not contain and Not in the list are treated as met when the attribute is missing;
- no provider yet applies conditions of the Membership type.
Fields
The list of fields is fixed; a field left without an attribute is not imported. The attributes are prefilled according to the provider.
In the advanced options, choose On creation only for a field to correct by hand: in Synchronized mode, each synchronization overwrites it. A missing attribute does not change the field; an attribute with several values gives only the first, including in filters. For the language, only fr, de, en and it are kept ("fr-CH" becomes "fr"); another language is ignored and reported in the log.
Access and rights
A new import creates no access: people enter without an account or invitation, and only the PhishTrainer role Target can be given to them, since a target never logs in. To give a right that requires a login, turn on the switch of the With a login to the portal area: each person without an account then receives one, with an invitation. A service left aside is neither given to nor removed from anyone, and you can set it afterwards in People.
Simulate, synchronize, schedule
The buttons of the Launch step stay inactive as long as the connection is not saved or the fields are not defined. Simulate before the first synchronization and after each change of groups, filters or fields: the simulation shows the planned action for each object, without writing anything.
A synchronization started by hand begins at the server’s next pass; cancelling it does not undo what is already done.
If the import creates access (the Access and rights step), a real synchronization creates the login accounts of the people who do not have one and sends an invitation by email to each of them; if there are many, the invitations go out in batches. An account that already has a password is never reset.
People no longer in the directory
What the import had brought in and is no longer there (deleted from the directory, removed from the selected groups or excluded by a filter) follows your choice: with Disable, the person loses the accesses given by the import; with Delete, they are removed from the organization and its groups, and a group is deleted along with its memberships. A person still brought in by another active import is not touched.
The Log gives the reason for each ignored line. A person is refused if their email address already exists for another organization, or if their domain is not among the allowed email domains of your organization: contact us. Unticking Import active suspends the automatic synchronization.
Deleting an import erases its configuration; the people and groups already synchronized stay in the organization. For an import with SSO, first read "Turn off SSO".
Importing a CSV file
Without a directory, upload a file. It is read in your browser: only the values of the selected columns are sent.
- Column names are free: at the Fields step, you choose the column of each field to import, and those of the template are recognized automatically.
- A column must be mapped to the email: it is the email that identifies the person, unless the file carries a column named
externalId. Re-importing a person updates their fields without creating a duplicate. - Title:
Mr,MrsorDr, or the full forms (Mister, Miss, Doctor). Language:fr,de,enorit. Another value is ignored, without excluding the person. - Groups: up to three per person, one column per group (
group1togroup3in the template). The name is compared without regard to case. A missing group is created at launch, then managed in Groups like a group created by hand. A group maintained by a directory is not fed by a file.
If the import creates access (the Access and rights step), the launch creates the login accounts of the people who do not have one and sends them an invitation. Before launching, the Launch step shows the number of people to import, the lines set aside with their reason and the addresses whose domain is not allowed; the number of people created or updated is then read in the History.
A file import has neither frequency nor simulation. It adds people and updates those it knows, without disabling or deleting anyone, and without removing anyone from a group: a person absent from the next file stays in the organization; if they have left, remove their accesses in People. The settings (fields, filters, rights) are kept for the next file.
SSO sign-in
SSO (OpenID Connect) lets people sign in with the company account. It exists for Entra ID, Google Workspace, Okta and Keycloak, and requires at the provider a sign-in application separate from the settings of the Connection step (see the provider’s article).
Default values: scopes openid profile email (openid required), claims sub, email, given_name and family_name. Declare at the provider all the redirect URLs shown (portal and Academy), then check with Test discovery: the issuer must be reachable from the Internet.
Enable SSO
Saving these settings does not enable SSO: to enable it, contact support. After that, synchronizations create the accounts without a password or invitation, and a person with no email in the directory gets no account.
Turn off SSO
Emptying the Issuer, unticking Import active on the SSO import or deleting that import turns off SSO for the whole organization.
Accounts without a password lose SSO access. The next synchronization restores an access for them with a password and an invitation. A person who uses "lost password" before that synchronization can never again be linked to SSO.
Didn’t find the answer? Contact us