Register Custom Drivers

A custom Driver is essentially a simple API service. Therefore, you need to notify Humanitec about how to consume it. This process is only available via the Humantec API.

The registration process is completed via a single POST request to the Humanitec API at the following endpoint.

https://api.humanitec.io/orgs/{orgId}/resources/drivers

Notify Humanitec about the type of Driver, the types of account credentials supported, the Driver-specific input parameters (as a JSON Schema), whether to make the Driver publicly available, the URL that it can be accessed from, and give it an id.

Custom Driver example 

export HUMANITEC_ORG="my-org"
export HUMANITEC_TOKEN="my-token"
curl -X POST https://api.humanitec.io/orgs/${HUMANITEC_ORG}/resources/drivers \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${HUMANITEC_TOKEN}" \
   -d @- <<EOF
{
  "id": "demo-driver",
  "type": "s3",
  "account_types": [
    "aws"
  ],
  "inputs_schema": $(cat my_driver_schema.json),
  "is_public": false,
  "target": "https://drivers.example.com/s3/"
}
EOF

Manage Custom Drivers

Virtual Drivers