Authentication

Most of the API endpoints for Searchcraft Cloud require authentication. For self-hosted instances of Searchcraft, authentication is optional and may be configured in the CLI options.

These endpoints are only available to self-hosted instances of Searchcraft, Searhcraft Cloud customers only interact with these via the Vektron application. Requires an admin level authentication key to access. See the CLI documentation for more information.

API Endpoints

• GET /auth/application/:application_id Returns a list of all keys for the application.

• GET /auth/federation/:federation_name Returns a list of all keys associated with a federation entity.

• GET /auth/organization/:organization_id Returns a list of all keys for the organization.

• GET /auth/key Returns a list of all keys on the cluster.

• POST /auth/key Create a key.

  • Payload format:

      {
        "allowed_indexes": ["index_name_1", "index_name_2"], // may contain one to several index names
        "permissions": 1, // 1 = read, 15 = ingest, 63 = admin.
        "name": "Name Of This Key",
        "organization_id": 0,
        "organization_name": "My Org Name",
        "application_id": 1,
        "application_name": "My App Name",
        "status": "active | inactive",
        "federation_name": "1_rest_name", // * optional and only needed for read keys associated with a federation
      }

• DELETE /auth/key Delete all keys.

• GET /auth/key/:key Get an individual key.

• DELETE /auth/key/:key Delete an individual key.

• POST /auth/key/:key Update an individual key.

Notes

• Organization and application IDs are used within Searchcraft cloud but are available for use in self-hosted instances at the customer’s discretion.
• The permissions identifiers may change in future releases of Searchcraft as more capabilities are added to the API.