Skip to main content

UIPlugin

API response for a plugin instance (tenantId and internal fields omitted)

Properties​

NameTypeDescriptionNotes
plugin_instance_idstrUnique identifier of the plugin instance[required]
aliasstrTenant-unique alias for the plugin instance, normalized to lowercase[required]
namemap[string]strLocalized string keyed by locale code. At least one non-empty locale entry is required on create/update. Conventionally includes en.[required]
descriptionmap[string]strLocalized string keyed by locale code. At least one non-empty locale entry is required on create/update. Conventionally includes en.[required]
api_scopes[]strOAuth scopes the plugin requests at registration[required]
content_security_policiesmap[string]List[str]Map of directive name to allowlist values. Used for CSP, Permissions-Policy, and iframe-allow on create/update. Only platform allowlisted directives/keywords are accepted (see UMS validators).[required]
permission_policymap[string]List[str]Map of directive name to allowlist values. Used for CSP, Permissions-Policy, and iframe-allow on create/update. Only platform allowlisted directives/keywords are accepted (see UMS validators).[required]
iframe_allowmap[string]List[str]Map of directive name to allowlist values. Used for CSP, Permissions-Policy, and iframe-allow on create/update. Only platform allowlisted directives/keywords are accepted (see UMS validators).[required]
iframe_sandbox[]strOpt-in iframe sandbox grants, de-duplicated and sorted. Empty when the plugin has none, including instances created before this field existed.[required]
active_asset_bundle_idstrCurrently active asset bundle, or null/omitted if none uploaded yet[optional]
slots[]PluginSlot[required]
statePluginInstanceState[required]
createddatetimeISO 8601 creation timestamp[required]
modifieddatetimeISO 8601 last-modified timestamp[required]
}

Example​

from sailpoint.ui_plugins.models.ui_plugin import UIPlugin

ui_plugin = UIPlugin(
plugin_instance_id='2c918086-7b5f-4b3e-8a1c-2d3e4f5a6b7c',
alias='my-custom-plugin',
name={"en":"Example text","fr":"Texte d'exemple"},
description={"en":"Example text","fr":"Texte d'exemple"},
api_scopes=["idn:account:read"],
content_security_policies={"default-src":["'self'"]},
permission_policy={"default-src":["'self'"]},
iframe_allow={"default-src":["'self'"]},
iframe_sandbox=["allow-modals","allow-popups"],
active_asset_bundle_id='',
slots=[
sailpoint.ui_plugins.models.plugin_slot.Plugin Slot(
slot_id = 'full-page',
required_capabilities = ["ORG_ADMIN"],
restrict_to_users = ["2c9180867b5f4b3e8a1c2d3e4f5a6b7c"], )
],
state='ENABLED',
created='2024-08-16T14:16:58.389Z',
modified='2024-08-16T14:16:58.389Z'
)

[Back to top]