Skip to main content

📦 Extension packs

Extension packs are vendor types that ship with Sneakers-PAM but aren't installed until a site admin installs one. Once installed, a pack is a read-only type like the built-in ones: people can create secrets of it, and nobody can edit it. None of them has heartbeat, rotation or check-out.

🧰 Installing a pack​

Before you start​

  • You're a site admin, or you're using a personal token whose owner is one.

From the admin console​

  1. Open the admin console's Secret types page.
  2. Select Import extension pack….
  3. Select Install next to the pack you want. The dialog lists only the packs that aren't installed yet.

The same dialog also takes a pack of your own: paste its JSON under Or paste a pack and select Import.

From an agent​

An agent can list the packs with sneakers_list_extension_packs and install one by its id with sneakers_import_extension_pack, but only through a token whose owner is a site admin or root. The new type then shows in sneakers_list_secret_types for everyone. Each install through a token is written to the audit trail under the token's user. See Using the MCP.

Uninstalling​

An installed pack has an Uninstall action on the Secret types page. It's refused while any secret still uses the type.

📋 The packs​

Amazon IAM Access Key​

From Amazon Web Services. Type id: ext-aws-iam-key.

FieldKeyKindRequiredSecret
Account IDaccountIdTextNoNo
Access Key IDaccessKeyIdTextYesNo
Secret Access KeysecretAccessKeyPassword (can be generated)YesSensitive

Microsoft Azure AD Account​

From Microsoft Azure. Type id: ext-azure-ad.

FieldKeyKindRequiredSecret
Tenant IDtenantIdTextYesNo
Application (client) IDappIdTextYesNo
Client secretclientSecretPassword (can be generated)YesSensitive

Google Cloud Service Account Key​

From Google Cloud. Type id: ext-gcp-sa-key.

FieldKeyKindRequiredSecret
Project IDprojectTextYesNo
Service account emailclientEmailTextYesNo
Key (JSON)keyJsonPassword (can be generated)YesSensitive

Docusign App SSH Keys​

From Docusign. Type id: type-docusign-ssh-keys.

FieldKeyKindRequiredSecretNotes
Integration Key (Client ID)integrationKeyTextYesNo
User ID (Impersonated user GUID)userIdTextYesNo
API Account IDapiAccountIdTextYesNo
Base URIbaseUriTextNoNodefaults to the Docusign demo environment
RSA Private KeyprivateKeySecret value (never generated)YesSensitive