Assets
term definition characteristics assets saved credentials and key/value pairs that help you connect to technologies, and also serve as a key store for commonly used sets of keys and values can be for a specific connector or customized, which can be applied to any action inputs most useful for standardizing and securing configurations | assets can be for a specific connector or customized, which can be applied to any action inputs, and are most useful for standardizing and securing configurations in turbine canvas, assets can be configured in your playbook allowing you to configure a connector and its asset without leaving the playbook canvas when to use assets you need to reuse credentials or common settings across playbooks you want to avoid storing secrets directly in playbook inputs you want consistent configuration for connector actions security tips use least privileged credentials for assets rotate secrets on a regular schedule review which playbooks depend on an asset before changing it key benefits of assets standardization assets ensure that sensitive data, such as api keys, credentials, and other key value pairs, are consistently applied across different playbooks, avoiding manual input errors security by centralizing credentials and keys in assets, they can be managed and updated in a single location, improving security management and reducing potential exposure to unauthorized users efficiency assets allow for seamless automation as they can be reused across multiple playbooks, simplifying playbook configuration by predefining commonly used values and connections scalability with assets, managing large scale environments with multiple playbooks becomes easier a single update to an asset can propagate across all playbooks where it is used, simplifying maintenance integration flexibility assets enable greater flexibility when connecting to multiple technologies by customizing the key value pairs for specific connectors, without the need to modify each individual action homepage to access assets, follow these steps log in to turbine from the left hand navigation pane, click orchestration and click assets from the assets homepage, a list of existing assets is shown, automatically sorted alphabetically you can use the features listed in the table to navigate the assets homepage for a faster and easier experience feature function filter by name use to filter by asset name plus icon select an asset type and view connector details (if applicable) ellipsis icon click to edit an asset from the homepage or delete an asset edit an asset if you want to edit an asset from the homepage click the ellipsis icon and select edit asset the edit asset window opens from here, modify the asset as needed and then save edit connector assets to edit an existing asset navigate to orchestration > assets locate the asset you want to modify click the ellipsis (⋮) menu next to the asset select edit asset the edit asset page opens and contains the following tabs configuration – manage asset settings, parameters, and connection validation usage – view where the asset is being used history – review connection testing and monitoring activity configuration tab use the configuration tab to update asset settings and asset parameters for connector assets, you can run test connection , enable enable automatic testing , and review outcomes on the history tab for prerequisites, eligibility by asset type, step by step procedures, bulk testing from configuration manager, and troubleshooting when a connector does not support testing, see test connector assets https //app archbee com/docs/wdlpsa7glls1ghfgxbo9d/1rppy3614jsmibl0b6pky history tab the history tab shows asset creation and modification events, manual and automatic connection tests, and failed test details history is retained for seven days for connection test statuses, activity types, and how to view failure details, see test connector assets https //app archbee com/docs/wdlpsa7glls1ghfgxbo9d/1rppy3614jsmibl0b6pky usage tab the usage tab displays all playbooks and components that currently use the asset use this tab to identify where an asset is configured understand which actions depend on the asset navigate directly to the associated action test an action using the asset asset usage information the usage table displays all locations where the asset is configured the table contains the following columns column description type indicates whether the asset is used in a playbook or component name name of the playbook or component where the asset is configured action the action that uses the asset view & test opens the associated action and its test console open and test an action to test an action that uses the asset open the asset in edit asset mode select the usage tab locate the playbook or component you want to review click the view & test icon the platform opens the associated action and displays the action's test tab provide test inputs some actions require input values before they can be tested you can provide inputs in one of the following ways from previous run – select a previous execution from the drop down list to automatically populate available input values manual entry – enter the required input values directly into the test fields if the selected previous run does not contain values for a particular input, that field is not automatically populated and must be entered manually run the test after the required inputs are provided click test review the results displayed in the result section of the test console the test console displays the action output and any related execution details tests executed from the usage tab are independent of asset connection testing see test connector assets https //app archbee com/docs/wdlpsa7glls1ghfgxbo9d/1rppy3614jsmibl0b6pky for how connection testing differs from action testing to manage connector assets across multiple tenants, perform bulk connection testing, or monitor asset health centrally, see configuration manager https //app archbee com/docs/wdlpsa7glls1ghfgxbo9d/o4gep3vq8u6zcsjyl jbo and test connector assets https //app archbee com/docs/wdlpsa7glls1ghfgxbo9d/1rppy3614jsmibl0b6pky create asset from homepage if you do not see an existing asset on the homepage, you can create a custom asset a custom asset has a key icon details on creating custom assets are further in this section keep scrolling! click the plus icon to open the configure your connector asset window in the title and name fields, enter a title and name these fields are required click add a property to select the property type to configure after you click create, the custom asset is now available from the assets homepage configure assets in canvas want to apply an asset without mapping to your playbook inputs manually? watch as we apply the existing virus total (vt) asset to connectors inside a component let us use the same virustotal connectors from the components # page example the following image shows the expanded virus total url analysis component inside are two vt connectors that need to have the vt asset applied open it in the component builder to apply the asset click on the individual action to enable the action panel details on the right hand side of the canvas expand the asset section in the drop down menu, select the virustotal asset repeat for the next vt action now your asset is applied to the action if you wish to modify the data, simply click the configure hyperlink and modify the action inputs, outputs, or test manually custom assets to access assets, follow these steps log in to turbine from the left hand navigation pane, click orchestration and click assets click the plus icon to open the select an asset type window the first available asset is the custom asset, where you can map static data and product specific values that can be referenced across multiple playbooks and multiple actions after you click create, the next configuration step automatically opens where you can set up the title and name for your asset and add any properties as asset inputs to apply to actions in your playbook the following example shows that we have created a custom asset using a string property to create a google endpoint the input name shown needs to be an exact match to the action input key where you want to use this asset value once you've configured, click create and the custom asset is now available from the asset homepage a unique identifier is knowing that all of your custom assets will have a key icon delete assets to delete assets on orchestration, click assets click the vertical ellipsis icon next to the asset you want to edit click delete a confirmation dialog shows any playbooks that become disabled by deleting that asset to view the playbooks listed, click the individual playbook hyperlink to continue and delete, click the delete icon and hold if deleting that asset does not disable any playbooks, the following confirmation dialog shows to continue and delete, click the delete icon and hold when deleting a custom asset, any playbooks that would be disabled by deleting the asset is shown in a dialog