Plan: dostęp SSH do maszyn¶
[PLAN] Stan na 2026-09-25.
Dotyczy sposobu, w jaki ludzie i automaty logują się na maszyny.
W logintegra-ansible obejmuje role users i teamcity_access oraz moduł Terraform instance.
1. Stan dzisiaj¶
| Kto | Konto na maszynie | Czym się uwierzytelnia | Uprawnienia |
|---|---|---|---|
Ansible (ludzie i logintegra-dev) |
ansible |
jeden wspólny klucz - para ansible/playbooks/ansible_key.pub |
sudo bez hasła (grupa superadmin) |
| TeamCity (deploy) | teamcity |
klucz agentów TeamCity (teamcity_access_authorized_keys) |
zapis do webapps/, sudo tylko na tomcat.service, grupa docker |
| ludzie (diagnoza) | konta osobiste z roli users |
klucze osobiste (users_accounts) |
bez sudo |
| ? | root, ubuntu |
klucze projektu Scaleway wstrzykiwane przy starcie (do sprawdzenia) | pełne |
Konto ansible zakłada cloud-init na nowych maszynach (moduł instance) i playbook create-ansible-user.yaml na starych.
2. Problemy¶
| Problem | Na czym polega |
|---|---|
| brak rozliczalności | każda zmiana z Ansible jest w logach jako ansible. Nie wiadomo, która osoba ją zrobiła ani czy to był TeamCity. |
| wyciek klucza daje roota wszędzie | jeden klucz prywatny daje sudo bez hasła na każdej maszynie, nowej i starej. Klucz nie wygasa. |
| droga rotacja | nowy klucz wymaga nowego ansible_key.pub, playbooka na wszystkich hostach i nowej kopii klucza u każdego posiadacza. Cloud-init działa tylko przy pierwszym starcie. |
| odejście osoby z zespołu | wymusza rotację dla wszystkich, bo wspólnego klucza nie da się odebrać jednej osobie |
| nie wiadomo, kto ma klucz | miejsce przechowywania klucza prywatnego nie jest nigdzie zapisane, patrz ANSIBLE_PRIVATE_KEY_FILE w Konfiguracji |
| druga, niezarządzana droga wejścia | Scaleway zwykle dopisuje klucze SSH projektu do root, a cloud-init zostawia użytkownika ubuntu. Ta ścieżka omija całe repo. |
To samo w mniejszej skali dotyczy konta teamcity - jeden klucz agentów bez ograniczenia, skąd może być użyty.
3. Warianty¶
| Zmiana | Koszt | Rozwiązuje | |
|---|---|---|---|
| A | rozdzielenie ludzi i automatów + ograniczenia kluczy | godziny | wyciek klucza poza zaufaną siecią, rozliczalność ludzi, druga droga wejścia |
| B | certyfikaty SSH (CA) | dni | rotacja, odejścia, wygasanie, rozliczalność wszystkich; opcjonalnie klucze hostów po odtworzeniu maszyny |
| C | mniej SSH: konfiguracja wypiekana w obraz przez Packer z tymi samymi rolami | tygodnie | Ansible przestaje logować się na działające maszyny |
Rekomendacja: A teraz, B jako cel. C dopiero wtedy, gdy czas odtworzenia maszyny (Terraform + Ansible) stanie się problemem.
Odrzucamy ansible-pull, w którym maszyna sama pobiera repo i stosuje role.
Wymaga on poświadczeń do repo i hasła ansible-vault na każdej maszynie.
4. Etap A - rozdzielenie i ograniczenia¶
- Ludzie uruchamiają Ansible z własnego konta (
ansible-playbook -u jan_kowalski). Rolausersdostaje grupę zsudobez hasła dla administratorów - dziś robi tolineinfilew/etc/sudoerswcreate-ansible-user.yaml; w roli jako plik w/etc/sudoers.d/zvalidate: visudo -cf %s. Przypisanie przezgroups: superadminwusers_accounts, tylko dla administratorów. - Konto
ansibletylko dla automatów (logintegra-dev, docelowo TeamCity). Klucz z opcjąfrom=: Skradziony klucz nie działa spoza tych adresów. W cloud-init przezssh_authorized_keysz opcjami, w roli przezkey_optionsmodułuauthorized_key. - Konto
teamcity:from="151.115.54.254"(agent TeamCity) - przezkey_optionswteamcity_access. - Nowa para kluczy
ansible- obecna krążyła bez ewidencji. Klucz prywatny w sejfie z zapisanym miejscem i listą posiadaczy. - Druga droga wejścia: sprawdzić na nowej maszynie z Terraforma, czy
rootiubuntumają klucze projektu Scaleway. Jeśli tak, ustawiamyPermitRootLogin now pliku wsshd_config.d/i usuwamy- defaultz cloud-init. Klucze projektu zostają tylko na wypadek awarii, bo konsola szeregowa Scaleway działa bez SSH. - Dokumentacja: Konfiguracja -
ANSIBLE_REMOTE_USER= własne konto.
Gotowe, gdy: auth.log na maszynie pokazuje osobę przy każdej zmianie z Ansible, a klucz ansible użyty spoza logintegra-dev / VPN jest odrzucany.
5. Etap B - certyfikaty SSH¶
Maszyny ufają jednemu kluczowi publicznemu (CA). Ludzie i automaty dostają krótko żyjące certyfikaty podpisane przez CA.
sequenceDiagram
autonumber
actor P as Osoba / TeamCity
participant CA as CA (np. step-ca)
participant H as Maszyna
P->>CA: logowanie (SSO / token CI)
CA-->>P: certyfikat: principal jan_kowalski, ważny 8 h,<br/>(CI: source-address agenta)
P->>H: ssh jan_kowalski@host z certyfikatem
H->>H: TrustedUserCAKeys: podpis CA OK,<br/>principal = nazwa konta, termin OK
H-->>P: sesja, w auth.log ID certyfikatu = osoba
Co to zmienia:
| Dziś | Z certyfikatami |
|---|---|
klucze osób w users_accounts, dopisywane na każdej maszynie |
na maszynie tylko klucz publiczny CA (TrustedUserCAKeys), jedna linia w cloud-init |
odejście osoby = users_absent + rotacja wspólnego klucza |
przestajemy podpisywać; ważne certyfikaty wygasają w ciągu godzin |
| klucz bez daty ważności | certyfikat ważny np. 8 h dla ludzi, na czas buildu dla CI |
wspólne ansible |
ID certyfikatu (osoba, build) w auth.log |
ograniczenie IP przez from= w authorized_keys |
source-address w samym certyfikacie CI |
Decyzje do podjęcia w tym etapie:
- Wybór narzędzia CA.
step-cato samodzielny serwer z logowaniem przez OIDC. Silnik SSH w HashiCorp Vault wchodzi w grę, jeśli „Vault” z naszych dokumentów to HashiCorp Vault, a nie menedżer haseł. Na start wystarczy też ręcznessh-keygen -sz kluczem CA w sejfie. - Principals: nazwa konta osobistego = principal; konto
ansibleprzyjmuje tylko principal CI (AuthorizedPrincipalsFile). - Certyfikaty hostów (opcjonalnie, później): CA podpisuje klucz hosta przy tworzeniu maszyny, klienci ufają wpisowi
@cert-authoritywknown_hosts. Odtworzona maszyna ma nowy klucz hosta, ale ważny certyfikat - bezStrictHostKeyChecking=noi bez ostrzeżeń. Łączy się z pytaniem 4 z planu TeamCity.
Migracja bez przerwy w dostępie:
- CA i
TrustedUserCAKeysna maszynach obok dotychczasowych kluczy. - Ludzie i TeamCity przechodzą na certyfikaty; stare klucze dalej działają.
- Po okresie przejściowym:
users_exclusive_keys: truez pustą listą kluczy -authorized_keyspustoszeje, zostaje tylko CA.
Gotowe, gdy: żadna maszyna z IaC nie ma statycznych kluczy w authorized_keys, a odejście osoby nie wymaga żadnej zmiany na maszynach.
6. Etap C - mniej SSH (opcjonalnie)¶
Obraz maszyny budowany przez Packer z tymi samymi rolami Ansible; Terraform tworzy maszyny z gotowego obrazu. Ansible uruchamia się przy budowie obrazu, nie na działających maszynach - zmiana konfiguracji = nowy obraz + odtworzenie maszyny. Zgodne z zasadą niezmiennych maszyn (FAQ) i skraca tworzenie środowisk na żądanie. Koszt: pipeline obrazów i ich wersjonowanie.
7. Otwarte pytania¶
- Gdzie jest klucz prywatny
ansiblei kto go ma? - Jaki adres IP ma
logintegra-dev? Potrzebny jest dofrom=w etapie A. - Czy „Vault” w naszych dokumentach to HashiCorp Vault? Od tego zależy narzędzie CA w etapie B.
- Czy maszyny z Terraforma mają klucze projektu Scaleway w
rootalboubuntu? Do sprawdzenia na pierwszej maszynie ztest.tfvars.
Ostatnia zmiana: 2026-09-28 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e