Secret Input

Use the Secret Input component to avoid storing sensitive data such as passwords and API keys within Grasshopper. The Secret Input component allows instead to reference a so-called secret defined securely on the ShapeDiver platform.

Accessing the secret value can only be done after authenticating to your ShapeDiver account, and therefore will be safe even when other people gain access to the Grasshopper definition.

Defining secrets

You can define secrets in the developers section of your ShapeDiver dashboard. Read more about how to define secrets here.

Authentication

In order to use the component, you will need to authenticate to your ShapeDiver account from Grasshopper. You can always authenticate using the “Log In” button from the top-level ShapeDiver menu in Grasshopper. It will also be triggered as soon as the Secret Input component is added to the document. A web browser will then open and ask you if you agree to authenticate to your ShapeDiver account.

Listing the existing secrets

Right-click on the component and open the “Secret name” sub-menu to see a list of secrets stored from your account. Once you pick a secret name, the component will output its value through its single output, and you can safely use it further in the definition.

After creating, modifying or deleting secrets on the platform, click on the “Clear cache” button in order to get the updated list.