立即与支持人员聊天
与支持团队交流

Password Manager 5.14.2 - Administration Guide (AD LDS Edition)

About Password Manager Getting Started Password Manager Architecture
Password Manager Components and Third-Party Solutions Typical Deployment Scenarios Password Manager in a perimeter network Management Policy Overview Password Policy Overview reCAPTCHA Overview User Enrollment Process Overview Questions and Answers Policy Overview Data Replication Phone-Based Authentication Service Overview Configuring Management Policy
Management Policies
Checklist: Configuring Password Manager Understanding Management Policies Adding or cloning a new Management Policy Configuring Access to the Administration Site Configuring Access to the Password Manager Self-Service Site Configuring Access to the Helpdesk Site Configuring Questions and Answers Policy Workflow overview Custom workflows Custom Activities Password Manager Self-Service Site workflows Helpdesk Workflows User Enforcement Rules
General Settings
General Settings Overview Search and Logon Options Import/Export Configuration Settings Outgoing Mail Servers Diagnostic Logging Scheduled Tasks Web Interface Customization Instance Reinitialization Realm Instances AD LDS Instance Connections Extensibility Features RADIUS Two-Factor Authentication Internal Feedback Customizing help link URL Password Manager components and third-party applications Unregistering users from Password Manager Bulk Force Password Reset Fido2 key management Working with Redistributable Secret Management account Email templates
Upgrading Password Manager Password Policies Enable 2FA for Administrators and Enable 2FA for HelpDesk Users Reporting Accounts Used in Password Manager for AD LDS Appendix B: Open Communication Ports for Password Manager for AD LDS Customization Options Overview Third-party contributions Glossary

Custom Activities

There are two options to create a custom activity: you can create a custom activity from scratch or convert a built-in activity to custom.

For any custom activity, you can specify a display name, a short name (used to address the activity in scripts), a description (used on the Administration Site), and add PowerShell script to the activity. When you create the custom activity from scratch, you can also select user interface elements and enter the main instruction for the page of the Self-Service or Helpdesk Site that will be displayed when the activity is executed.

NOTE: You cannot specify any user interface elements for custom activities converted from built-in ones. If you want set user interface elements for your custom activity, create it from scratch.

For more information on writing PowerShell scripts for custom activities, refer to the Password Manager SDK.

IMPORTANT: You can create custom activities only after you turn on the extensibility features. You can turn on the extensibility features on the General Settings tab of the Administration Site.

Custom Activity Settings

When you use custom activities in your workflows, you need to understand how shared settings of custom activities work.

All settings (display name, short name, description, PowerShell script, and user interface elements) that you specify for custom activities created from scratch are shared i.e. if you modify any of these settings for a custom activity included in or excluded from a workflow, the changes will be automatically propagated to all instances of this activity in all workflows and Management Policies.

If you create a custom activity by converting a built-in activity, the custom activity has two types of settings: built-in and shared. Built-in settings are the settings inherited from the built-in activity. Such settings are not shared: if you modify them, the changes will be applied only to the current activity instance. But if you modify the shared settings (display name, short name, description, PowerShell script), such changes will be propagated throughout all instances of this activity.

For example, if you modify the PowerShell script for your custom activity “My Custom CAPTCHA”, when you save the activity, the updated settings will be applied to all instances of the “My Custom CAPTCHA” activity used in other workflows and Management Policies. But if you modify the built-in setting (noise level) of the “My Custom CAPTCHA” activity, when you save the activity, the changes will be applied only to this instance of the activity. The noise level setting of other instances of the “My Custom CAPTCHA” activity will not be changed.

Creating custom activities

When you create a custom activity from scratch or by converting a built-in activity, the created custom activity in the Custom group of the activities list in the workflow designer. If you want to copy the created activity, hover over the activity in the left pane of the workflow designer, and click Copy.

Note, that this functionality is available only after you turn on the extensibility features.

To turn extensibility features on

  1. Open the Administration Site and click the General Settings tab.

  2. On the General Settings page, select the Extensibility tab.

  3. On the Extensibility settings page, click the upper Turn on button.

To create a custom activity from scratch

  1. On the Administration Site, open the workflow designer, expand the Custom group in the left pane, and click Add new custom activity.

  2. On the User Interface Designer tab, enter the main instruction for the activity in the default language. You can translate the main instruction text into other languages by clicking the Add new language link. This text will be displayed on the page of the Self-Service or Helpdesk Site page when the activity is executed. Any user interface elements that you add will be displayed below the main instruction.

  3. To add user interface elements, click Add new element in the User interface elements section.

  4. In the Add New Element dialog, select the user interface element you want to add and enter the element’s ID and label. Select the following options if required:

  5. Click OK:

    • Disable the element on the user interface: Select this check box if you want to make this element disabled on the Self-Service or Helpdesk Site.

    • Hide the element on the user interface: Select this check box if you want to hide this element from the Self-Service or Helpdesk Site.

  6. On the Activity Name tab, specify the following options:

    • Activity short name: The activity name that should be used in PowerShell scripts to refer to the activity.

    • Activity display name: The activity name displayed in the activities list and workflow designer.

    • Activity description : Your description of the custom activity.

  7. On the PowerShell Script tab, enter the PowerShell script to set the activity behavior. For more information on how to create and use activity scripts, refer to the Password Manager SDK.

  8. Click OK.

Any built-in activity (Self-Service or Helpdesk) can be converted to a custom one by clicking the Convert to custom activity link on a built-in activity in the activities list or the workflow designer. If you want to copy the created activity, hover over the activity in the left pane of the workflow designer, and click Copy.

To convert a built-in activity to a custom activity

  1. On the Administration Site, open the workflow designer, select the built-in activity you want to convert, and click the Convert to custom activity link on the activity.

  2. Hover over the created activity and click the Shared settings link.

  3. On the Activity Name tab, specify the following options:

    • Activity short name . The activity name that should be used in PowerShell scripts to refer to the activity.

    • Activity display name. The activity name displayed in the activities list and workflow designer

    • Activity description . Your description of the custom activity.

  4. On the PowerShell Script tab, enter the PowerShell script to set the activity behavior. For more information on how to create and use activity scripts, refer to the Password Manager SDK.

  5. Click OK.

Importing and exporting custom activities

Using the import and export custom activity functionality, you can effortlessly share and copy custom activities that you created. If you want to reuse a custom activity in another workflow, export the activity to an archive file and then import it to the required workflow.

Note that you can import and export custom activities only. This functionality is available only after you turn on the extensibility features.

To turn extensibility features on

  1. Open the Administration Site and click the General Settings tab.

  2. On the General Settings page, select the Extensibility tab.

  3. On the Extensibility settings page, click the upper Turn on button.

To export custom activity

  1. On the Administration Site, open the workflow designer, expand the Custom group in the left pane of the workflow designer, hover over the custom activity you want to export, and click Export.

  2. Depending on your browser settings, specify where you want to save the archive file and download the archive.

When you import custom activities, note that existing custom activities with the same name will be replaced. You can back up existing activities by exporting them when prompted.

IMPORTANT: When you import custom activities, it is strongly recommended to audit activities’ scripts before using activities in a production environment. This is required because security-sensitive information can be accessed via PowerShell scripts included in a custom activity. Import custom activities from a trusted source only.

To import custom activity

  1. On the Administration Site, open the workflow designer, expand the Custom group in the left pane of the workflow designer, and click Import custom activity.

  2. In the Import Custom Activity dialog, click Upload to select the activity archive file and then click OK.

相关文档

The document was helpful.

选择评级

I easily found the information I needed.

选择评级