Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/infrahq/infra
Infra provides authentication and access management to servers and Kubernetes clusters.
https://github.com/infrahq/infra
access go golang iam identity infra infrastructure kubernetes login oidc security
Last synced: about 2 months ago
JSON representation
Infra provides authentication and access management to servers and Kubernetes clusters.
- Host: GitHub
- URL: https://github.com/infrahq/infra
- Owner: infrahq
- License: other
- Created: 2021-01-22T18:27:47.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-13T09:49:06.000Z (4 months ago)
- Last Synced: 2024-05-17T00:36:19.279Z (4 months ago)
- Topics: access, go, golang, iam, identity, infra, infrastructure, kubernetes, login, oidc, security
- Language: Go
- Homepage: https://infrahq.com
- Size: 51.6 MB
- Stars: 1,353
- Watchers: 13
- Forks: 55
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - infrahq/infra - Infra provides authentication and access management to servers and Kubernetes clusters. (Go)
- awesome-starred - infrahq/infra - Infra provides authentication and access management to servers and Kubernetes clusters. (security)
- awesome-k8s-resources - Infra - Infra enables you to discover and access infrastructure (e.g. Kubernetes, databases). We help you connect an identity provider such as Okta or Azure active directory, and map users/groups with the permissions you set to your infrastructure. (Tools and Libraries / Command Line Tools)
- my-awesome - infrahq/infra - 09 star:1.4k fork:0.1k Infra provides authentication and access management to servers and Kubernetes clusters. (Go)
README
[Infra](https://infrahq.com) provides authentication and access management to servers, clusters, and databases.
## Getting Started
#### macOS
```
brew install infrahq/tap/infra
```
#### Windows
```powershell
scoop bucket add infrahq https://github.com/infrahq/scoop.git
scoop install infra
```
#### Linux
Download the [latest](https://github.com/infrahq/infra/releases/latest) packages from GitHub and install it with `dpkg`, `apt`, `rpm`, or `dnf`.
```
sudo dpkg -i infra_*.deb
sudo apt install ./infra_*.deb
sudo rpm -i infra-*.rpm
sudo dnf install infra-*.rpm
```
### Create an access key
Log in to Infra. If you don't have a self-hosted Infra configured, you can sign up for a [free Infra instance](https://signup.infrahq.com) to get started.
Set the INFRA_SERVER variable to your Infra URL:
```
export INFRA_SERVER=.infrahq.com
```
```
infra login
```
You'll be prompted for the Infra URL you created when you signed up. (e.g. `.infrahq.com`).
Then, create an access key:
```
INFRA_ACCESS_KEY=$(infra keys add --connector -q)
```
### Connect Kubernetes cluster
Install Infra connector via [helm](https://helm.sh):
```
helm repo add infrahq https://infrahq.github.io/helm-charts
helm repo update
helm install infra infrahq/infra --set config.server.url=$INFRA_SERVER --set config.accessKey=$INFRA_ACCESS_KEY --set config.name=example
```
### Access your cluster
Give yourself permission to access the cluster:
```
infra grants add example --role view
```
Use `infra list` to verify access.
Run `kubectl` to switch to your newly connected cluster.
```
kubectl config use-context infra:example
```
Alternatively, you can switch clusters via `infra use` command.
```
infra use example
```
Lastly, try running a command on the Kubernetes cluster:
```
kubectl get pods -A
```
## Next steps
Congratulations. You've successfully connected your first cluster.
Infra works best when used with a team. Next, configure how users authenticate by connecting an [identity provider](https://infrahq.com/docs/manage/authentication#identity-providers), or add users directly by [inviting them](https://infrahq.com/docs/manage/users-groups#adding-a-user).
## Community
- [Community Forum](https://github.com/infrahq/infra/discussions) Best for: help with building, discussion about infrastructure access best practices.
- [GitHub Issues](https://github.com/infrahq/infra/issues) Best for: bugs and errors you encounter using Infra.