Dynamic SSO

Create and update Goodays users at login from an approved set of Identity Provider attributes.

Authentication with tailored user provisioning

Dynamic SSO extends standard SAML v2 authentication with dynamic provisioning. The SAML response carries additional user attributes, which Goodays maps to the rules agreed for the project. At the user's first successful login, Goodays can create an account from these attributes. At later logins, the approved rules can update the user's profile, role or access scope.

The experience remains simple for the user. The integration behind it is tailored because every organization represents roles, points of sale and organizational structures differently.

🚧

Preliminary workshop and Goodays validation required

Dynamic SSO is not a ready-made configuration and must not be assumed to be available by default. Goodays first runs a workshop with your business and IT teams, reviews the requested behavior and available identity data, and confirms whether the integration is feasible. Implementation starts only after explicit Goodays validation.

When Dynamic SSO may be relevant

Dynamic SSO is intended for situations where manual account administration would create significant operational effort: for example, a large population, frequent organizational changes or users whose access depends on structured roles and points of sale.

It also requires reliable identity data. Your organization must provide the professional email address used as the unique Goodays identifier, along with controlled business roles and maintained organizational references through the IdP.

If the requirement is primarily corporate authentication, Static SSO remains the simpler option. It can be activated first, then extended with a separate Dynamic SSO project later.

What can be provisioned

According to the model approved for the project, SAML attributes can be used to:

  • Identify the user.
  • Create the Goodays account when it does not yet exist.
  • Update basic user information.
  • Select an agreed Goodays profile or role.
  • Determine which organizational levels, points of sale or groups the user can access.

Provisioning is evaluated during a successful login. Dynamic SSO is not a continuous directory-synchronization or generic SCIM service.

The preliminary workshop

The workshop brings together the client's identity specialists and the business owners who understand the expected Goodays access model. Together with Goodays, they describe:

  • The target user populations and journeys.
  • The identity data available through SAML.
  • The business meaning of roles and organizational references.
  • The expected account-creation and update behavior.
  • Representative cases such as several points of sale, role changes or missing values.

This discussion is necessary because a technical value such as manager, region or point_of_sale rarely has the same meaning in two organizations.

The attribute contract

The outcome of the workshop is a shared attribute contract. It defines how the client's identity model translates into Goodays accounts and access.

The following matrix is a working template for the workshop. In the Client label column, TBC means To Be Completed: your identity team replaces it with the corresponding attribute name from your IdP. The rows retained, their exact rules and their mandatory status are then confirmed for the project.

Goodays labelClient labelRulesExampleTypeMandatoryDefault valueDescription
usernameTBCMust contain the user's professional email address and uniquely identify the Goodays account.[email protected]StringYesNoneEmail address used to create or match the user.
first_nameTBCPassed from the IdP to the Goodays user profile.MichaelStringYesNoneUser's first name.
last_nameTBCPassed from the IdP to the Goodays user profile.ScottStringYesNoneUser's last name.
functionTBCClient values are mapped to the Goodays profiles agreed during the workshop.regional_managerString or listProject-dependentDefined in the contractBusiness role or function used to determine the Goodays profile.
lang_trainingTBCAccepted values and fallback behavior are agreed during the workshop.enStringNoDefined in the contractPreferred Goodays interface language, when provided.
siegeTBCThe meaning of the client value and its effect on the access scope must be explicitly approved.falseBooleanProject-dependentDefined in the contractIndicates whether the user may access all points of sale in the Goodays account.
placesTBCClient references for points of sale are matched to Goodays points of sale using the mapping approved for the project.SCRANTON_PAString or listProject-dependentDefined in the contractOne or more points of sale the user may access.
levelsTBCClient references are matched to the relevant Goodays organizational levels.NORTHEAST_REGIONString or listProject-dependentDefined in the contractAdditional organizational scope above an individual point of sale, when required.

For each retained attribute, the final contract records its business meaning, format, accepted values, source of truth and behavior when the value is absent, unknown or changes. The labels and examples above describe the expected structure; they are not a ready-to-use configuration.

Goodays validation

After the workshop, Goodays assesses whether the available attributes are sufficiently stable and unambiguous, whether the requested access model can be translated into maintainable rules, and what implementation approach is appropriate.

Goodays then confirms whether the project can proceed and defines the next delivery steps. Holding the workshop does not by itself guarantee approval.

Implementation

Once the project is approved, Goodays and your identity team configure SAML and the agreed provisioning rules. Validation uses representative users to confirm first-login creation, later updates and the resulting roles and scopes.

Production activation occurs only after both the technical journey and the expected business access have been agreed. The delivery plan is defined from the validated specification rather than from a universal setup procedure.


What’s Next

Prepare your identity model and business access rules for the preliminary workshop.