Add and manage scripts
To add and manage available scripts for DigiCert® agents, go to the Discovery & automation tools > Scripts > DigiCert agents page in DigiCert® Trust Lifecycle Manager. From there, you can upload any script type to use with either Linux or Windows agents.
Before you begin
To use the script management functions described on this page, all DigiCert agents must be running software version
3.1.2or above. For details about how to update the software on an agent, see Software updates.For information about legacy scripts for agents prior to version
3.1.2and how to transition to the latest script management system, see Legacy agent scripts.
Add a script
To add a new agent script in Trust Lifecycle Manager:
In the Trust Lifecycle Manager menu, go to Discovery & automation tools > Scripts > DigiCert agents.
Open the Add script for dropdown on the top-right, and select DigiCert agents.
Complete the Add new script sidebar:
Name: Enter a user-friendly name for referencing the script.
Operating system: Select the applicable operating system (Linux or Windows).
Script type: Select the applicable script type.
Upload script: Drag and drop or browse to select the script to upload. Once uploaded, the name of the script appears below the widget.
Description: (Optional) Enter an optional description for the script to help identify it in Trust Lifecycle Manager.
Select Add and verify script to verify the script in Trust Lifecycle Manager. Once verified, the script is available for assignment.
Script verification process
When you add a script, Trust Lifecycle Manager scans it for malicious content:
If the script fails verification, you receive a notification and the script does not get added to Trust Lifecycle Manager. Review the script for any malicious content and try adding it again.
If the script passes verification, it gets uploaded to the content distribution network (CDN). The script appears on the Discovery & automation tools > Scripts > DigiCert agents page and shows
Activein the Status column. The script is now available for assignment to agents and automation requests.
Add a new version of a script
To add a new version of an existing agent script in Trust Lifecycle Manager:
In the Trust Lifecycle Manager menu, go to Discovery & automation tools > Scripts > DigiCert agents.
Find the script to update in the table, and select the pencil icon in the rightmost column.
In the Edit script sidebar, use the Upload script widget to drag and drop or browse to select the script to upload. Once uploaded, the name of the script appears below the widget.
Select Update and verify script to verify the new version of the script in Trust Lifecycle Manager. Once verified, the script replaces the previous version and is available for assignment.
Important
When adding a new version of a script, you can edit the script name or description, but you cannot change the operating system or script type. If the new version of the script fails verification, the previous version remains active.
Script statuses
The status indicates the current status of an agent script and whether it's ready to assign. You can view the status of a script in the Status column on the Discovery & automation tools > Scripts > DigiCert agents page.
Status | Description |
|---|---|
| The script was successfully verified and uploaded, and is available for assignment to DigiCert agents and automation requests. |
| The script passed verification, but could not be uploaded to the content delivery network (CDN). Check your network connection and try adding it again. |
| This is a legacy script. For details, see Legacy agent scripts. |
Manage scripts
To manage existing agent scripts in Trust Lifecycle Manager, use the management actions in the rightmost column of the Discovery & automation tools > Scripts > DigiCert agents table. Available management actions depend on the script status and may include the following.
What's next
Once a script has been added and verified in Trust Lifecycle Manager, you can assign it to agents.