Secrets#

Do not construct this object directly, instead access the secrets property of an ngrok.Client object.

class ngrok.services.SecretsClient(client)[source]#

Secrets is an api service for securely storing and managing sensitive data such as secrets, credentials, and tokens.

create(vault_id, name='', value='', metadata='', description='')[source]#

Create a new Secret

Parameters:
  • name (str) – Name of secret

  • value (str) – Value of secret

  • metadata (str) – Arbitrary user-defined metadata for this Secret

  • description (str) – description of Secret

  • vault_id (str) – unique identifier of the referenced vault

https://ngrok.com/docs/api#api-secrets-create

Return type:

Secret

delete(id)[source]#

Delete a Secret

Parameters:

id (str) – a resource identifier

https://ngrok.com/docs/api#api-secrets-delete

get(id)[source]#

Get a Secret by ID

Parameters:

id (str) – a resource identifier

https://ngrok.com/docs/api#api-secrets-get

Return type:

Secret

list(before_id=None, limit=None)[source]#

List all Secrets owned by account

Parameters:
  • before_id (str) –

  • limit (str) –

https://ngrok.com/docs/api#api-secrets-list

Return type:

SecretList

update(id, name=None, value=None, metadata=None, description=None)[source]#

Update an existing Secret by ID

Parameters:
  • id (str) – identifier for Secret

  • name (str) – Name of secret

  • value (str) – Value of secret

  • metadata (str) – Arbitrary user-defined metadata for this Secret

  • description (str) – description of Secret

https://ngrok.com/docs/api#api-secrets-update

Return type:

Secret