1
1
mirror of https://gitlab.archlinux.org/archlinux/infrastructure.git synced 2025-01-18 08:06:16 +01:00
infrastructure/docs/otp.md
Kristian Klausen 2a74897bfb
Add Vagrant Cloud account
Vagrant Cloud has been used for years by arch-boxes[1] for publishing
Vagrant boxes. Access to the organization[2] was handed out to a few
members of the DevOps team and the creator of the organization
(arch-boxes maintainer at the time).

With this commit the control of the organization is handed over to the
DevOps team through a new Vagrant Cloud account.

[1] https://gitlab.archlinux.org/archlinux/arch-boxes
[2] https://app.vagrantup.com/archlinux/
2022-05-29 21:20:06 +02:00

95 lines
2.7 KiB
Markdown

# Setting up OTP stuff for Arch's various accounts
Arch has master accounts with some service providers. These are to be treated with utmost
care for obvious reasons. We use 2FA where ever possible.
The general flow for these is:
- Install pass-otp: `pacman -S pass-otp`
- Use pass-otp to log in via a master seed
- (Optional) Depending on the service provider, you can then add your own authenticator
## GitHub
Run
pass otp insert -i GitHub -a archlinux-master-token github.com/archlinux-master-token -s
When asked for a secret, provide the `github_master_seed` from `misc/vaults/vault_github.yml`.
You can then run
pass otp code github.com/archlinux-master-token
to generate a token to log in.
Sadly, GitHub doesn't support multiple 2FA devices so this is all we get.
## Hetzner
Run
pass otp insert -i Hetzner -a archlinux-master-token Hetzner/archlinux-master-token -s
When asked for a secret, provide the `hetzner_master_seed` from `misc/vaults/vault_hetzner.yml`.
You can then run
pass otp code Hetzner/archlinux-master-token
to generate a token to log in.
## UptimeRobot
Run
pass otp insert -i UptimeRobot -a archlinux UptimeRobot/archlinux-master-token -s
When asked for a secret, provide the `2FA token seed` from `misc/vaults/additional-credentials.vault`.
You can then run
pass otp code UptimeRobot/archlinux-master-token
to generate a token to log in.
## Rsync.net
Run
pass otp insert -i rsync.net -a archlinux Rsync.net/archlinux-master-token -s
When asked for a secret, provide the `2FA token seed` from `host_vars/localhost/vault_rsync.net.yml`.
You can then run
pass otp code Rsync.net/archlinux-master-token
to generate a token to log in.
## Vagrant Cloud
Run
pass otp insert -i VagrantCloud -a archlinux VagrantCloud/archlinux-master-token -s
When asked for a secret, provide the `vagrant_cloud_seed` from `misc/vaults/vault_vagrant_cloud.yml`.
You can then run
pass otp code VagrantCloud/archlinux-master-token
to generate a token to log in.
### Adding your own account
Hetzner supports multiple 2FA devices at once which allows you to add your own 2FA app of choice
in addition to pass-otp.
To add yours, go to the 2FA management page: https://accounts.hetzner.com/tfa
Add a new authentication method with your username and add the token of this
key to either pass otp or an OTP tool of your choice.
Make sure to put your nickname into the description so we know who that key belongs to.
If you choose to use pass, you can add the key by running something
similar to `pass otp insert -i Hetzner -a archlinux Hetzner/archlinux -s`.
If you want to use your own tool, you can either scan the QR code or enter the shown string manually.