The Management API is the Kubernetes API of a Giant Swarm management cluster, allowing control over workload clusters and apps in a declarative fashion using the proven Kubernetes paradigms.
In this section, we provide instructions on how to authenticate for the Management API, both as a user and in an automation context. We also provide some technical background information and requirements for new customers.
Granting users specific permission to certain resources is what authorization is all about. The Management API uses Kubernetes' role based access control (RBAC) primitives and provides automation on top of it to make authorization easy for most real-life use cases. Here we explain them in detail.
- Provider credentials
Where to configure the cloud provider account/subscription to be used, and how to deposit credentials via the Management API.
- Creating workload clusters
Guides for all supported platforms, explaining in detail how to leverage the Management API to create and manage clusters in a declarative fashion.
Schema reference of all custom resource definitions (CRD) and custom resources (CR) you can use with the Management API.
- Client certificates for clusters
We recommend OIDC for authentication to the workload cluster Kubernetes API. However, in some scenarios, client certificates are a viable alternative. Here we explain how to create such certificates via the Management API.