Description:

The Set Admin Password workflow step belongs to the Tenants category in FlowWright. Its internal name is clssetadminpassword, its label is Sets the admin password for the tenant, and its display name is Set Admin Password. The step uses the FlowWright.Workflow.ClsSetAdminPassword namespace and FlowWright.Workflow.dll. It is defined as a Process step with two input connections and two output connections.

The Set Admin Password step uses a configured Tenant Manager connection, a tenant name or ID, an administrative user, and a new password to set the administrator password for the specified tenant. All four properties are required.

The step supports:

• Selecting a Tenant Manager connection
• Identifying a tenant by name or ID
• Specifying the administrative user
• Providing the new password
• True/False workflow branching 

This step can be used for:

• Tenant administration
• Tenant provisioning workflows
• Administrator account setup
• Tenant onboarding
• Controlled administrator password changes
• Tenant lifecycle management
• Automated tenant configuration

Usage:

The Set Admin Password step is typically placed in workflows where an administrative account must be configured, or its password changed for a particular tenant.

The workflow can dynamically supply the tenant and administrative-user information using:

• Workflow Variables
• Global variables
• Form values
• Previous workflow outputs
• Tenant-management information
• Data retrieved from other systems

The workflow can provide the tenant name or ID, administrative user, and new password as inputs to the step.

Example:

Let’s build and execute the “clsSetAdminPasswordDef” example.  

• Create a new definition named “clsSetAdminPasswordDef” and open it in designer mode. 
• Drag a "clsSetAdminPassword" step to the canvas.
• Connect the dots between the “Start” step and "clsSetAdminPassword" steps, as shown above. 
• Click the "clsSetAdminPassword" step to configure its “Required” properties. Provide a name for the step. Select the connection string. Enter the Tenant Name or GUID. Enter the admin username. Enter the new password, which is encrypted and stored in the database after execution. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description. 

• The “Logging” configuration is necessary for documentation and also measures workflow progress and percent complete. This is achieved by configuring the step state and percent fields individually, as shown in the images below. Configure the “Logging” using the following properties.

• Save the Process Definition. Create a new Process Instance and execute it. When the workflow reaches the Set Admin Password step, the configured Tenant Manager connection is used to set the password for the supplied tenant administrative user. The workflow then follows the True-or-False execution path defined for the step.

Tips:

• Select the correct Tenant Manager connection before executing the workflow.
• Verify that the Tenant name or ID identifies the intended tenant.
• Verify the Administrative user before changing its password.
• Treat the New password to set value as sensitive information.
• Avoid putting actual passwords directly into documentation, test definitions, source control, or unnecessary workflow logging.
• Use Variables or other controlled mechanisms when a password must be supplied dynamically, according to the security capabilities available in your FlowWright environment.
• Do not log the actual password value.
• Use an approval or authorization stage before automated password changes where required by organizational policy.
• Configure the False path so that a failed password update is handled explicitly.
• Test the workflow in a controlled environment before deploying it to production.
• Verify the target tenant and Tenant Manager connection carefully before execution.

Notes:

• Category: Tenants. 
• Internal name: clssetadminpassword. 
• Label: Sets the tenant's admin password. 
• Display name: Set Admin Password. 
• Namespace: FlowWright.Workflow.ClsSetAdminPassword. 
• DLL: FlowWright.Workflow.dll. 
• Step definition type: Process. 
• Input connections: 2. 
• Output connections: 2. 
• Tenant Manager connection: Required. 
• Tenant name or ID: Required. 
• Administrative user: Required. 
• New password: Required. 
• Returns: True and False.

Definition Sample:

You may download the sample definition(s) from the link provided and later import them into the FlowWright Process Definition (XML file) or Form Definition (HTML file) page.

Note: Verify and complete any missing configuration after importing the sample, including:

• Tenant Manager connection
• Tenant name or ID
• Administrative user
• New password
• Variable mappings, if applicable
• Environment-specific settings
• Workflow connections

After verifying the configuration, save the Process Definition before execution.

Click here to download the sample file.