Overview

Credentials (API keys, usernames, passwords, etc) can be simply and securely managed in Mitto on the Credentials page.

Individual jobs reference credentials by their name. So instead of storing credentials in individual job configurations, the named credentials are referenced. This allows users to have one location to update credentials across many jobs.

Add Credentials

Navigate to the Credentials page in Mitto.

Click "Add Credentials".

Fill out the "Add Credentials" form.

Reference the credentials in a Mitto job.

Credentials Types

Depending on the plugins installed on your Mitto instance, you may see different types of credentials.

  • Basic - Supports basic authentication (e.g. username and password).
  • Generic - Supports any existing credential type. Data is stored as JSON.

Edit existing Credentials

Click on the orange edit button next to any credentials to edit.

IMPORTANT: The entire credential is overwritten when you edit and save an existing credential. So, you must fill out the entire form before saving.

Example of Credentials Used in a Job

Salesforce Input

Here's an example of the credentials for the Salesforce input of an IO job:

{
  "input": {
    "credentials": {
      "password": "thisisthepassword",
      "security_token": "thisisthesecuritytoken",
      "username": "user@email.com"
    },
    "sobject": "Opportunity",
    "upsert_field": "SystemModstamp",
    "use": "sfdc.iov2#SalesforceInput"
  },
  ...
}

A generic credential can be created:

Now the IO job's input's credentials key can reference the name of the credential: Salesforce - user@email.com:

{
  "input": {
    "credentials": "Salesforce - user@email.com",
    "sobject": "Opportunity",
    "upsert_field": "SystemModstamp",
    "use": "sfdc.iov2#SalesforceInput"
  },
  ...
}