listSecrets

List secret names and metadata sizes from MATLAB vault

Since R2024a

Syntax

listSecrets

t = listSecrets

Description

listSecrets displays the names and metadata sizes of all secrets in your MATLAB^® vault. Your MATLAB vault is accessible only from the exact combination of your operating system account and local machine.

t = listSecrets creates a table with the secret names and metadata.

Examples

List Secret Names and Metadata Sizes

List the names and metadata sizes of all the secrets in your MATLAB vault.

listSecrets

       SecretName                       SecretMetadata                 
    ________________    _______________________________________________

    "PDFpassword"       {[dictionary (string ⟼ cell) with 2 entries ]}
    "AWS_access_key"    {[dictionary (string ⟼ cell) with 3 entries ]}
    "Azure_WASB_KEY"    {[dictionary (string ⟼ cell) with 2 entries ]}
    "OAuth_token"       {[dictionary (string ⟼ cell) with 3 entries ]}
    "certificate3"      {[dictionary (string ⟼ cell) with no entries]}
    "SFTPpassword"      {[dictionary (string ⟼ cell) with 4 entries ]}

Create Table of Secret Metadata

Assign the names and metadata sizes of all your secrets to a table.

t = listSecrets

t =

  6×2 table

       SecretName                       SecretMetadata                 
    ________________    _______________________________________________

    "PDFpassword"       {[dictionary (string ⟼ cell) with 2 entries ]}
    "AWS_access_key"    {[dictionary (string ⟼ cell) with 3 entries ]}
    "Azure_WASB_KEY"    {[dictionary (string ⟼ cell) with 2 entries ]}
    "OAuth_token"       {[dictionary (string ⟼ cell) with 3 entries ]}
    "certificate3"      {[dictionary (string ⟼ cell) with no entries]}
    "SFTPpassword"      {[dictionary (string ⟼ cell) with 4 entries ]}

Output Arguments

t — Secret names and metadata

table

Secret names and metadata, returned as a table.

More About

MATLAB Vault

Your secrets are stored in your MATLAB vault, which is accessible only from the exact combination of your operating system account and local machine. Your vault and secrets, which do not leave your local machine, persist across MATLAB sessions. Each secret consists of a name, value, and optional metadata.

• Secret name – A unique case-sensitive text identifier for the secret. The secret name is stored unencrypted in your vault as a string scalar.

• Secret value – A text value associated with the secret. The Secret Prompt dialog box, where you enter the secret value, supports copy-paste functionality. The secret value is stored encrypted in your vault using industry standard AES-256 encryption. The secret value is returned as a string scalar.

• Secret metadata – A dictionary containing additional information associated with the secret. The optional secret metadata is stored unencrypted in your vault.

To set a secret, use setSecret.

For increased security when you use MATLAB Online™, enable two-step verification for your MathWorks^® Account.

Version History

Introduced in R2024a