Handleiding › Aan de slag › Installeren

GitHub: klik hier en voer daarna deze stappen uit

Waarom dit onderdeel

Jouw systeem bestaat uit tekst en code, en die staan op GitHub: in een eigen opslag (een "repo") op jouw naam, zodat alles wat je agenten doen bewaard blijft en terug te lezen is. Wij zetten die opslag bij de installatie voor je neer, vanuit onze blauwdruk.

Daarvoor heb je een GitHub-account nodig, en wij een sleutel waarmee je Mac-server bij je opslag kan. Na vandaag hoef je zelf nooit meer op GitHub in te loggen: je agenten werken met die sleutel.

Wat je nodig hebt: je zakelijke mailadres en je telefoon.

Hoe lang: tien minuten.

Stap 1. Maak je GitHub-account aan

Klik hier: github.com/signup.

1. Vul je zakelijke mailadres in.
2. Laat 1Password het wachtwoord maken: ga naar onze 1Password, kluis <klantnaam>, nieuw item, type Login, naam precies GitHub, met je mailadres en het gegenereerde wachtwoord. Kopieer het van daar.
3. Kies een gebruikersnaam. Kort, zonder spaties, bijvoorbeeld je bedrijfsnaam. GitHub zegt meteen of hij vrij is. Wat je ziet: een formulier met mailadres, wachtwoord en gebruikersnaam, met een groen vinkje bij wat goed is.
4. Doorloop de controle ("ben je een mens") en typ de code over die GitHub naar je mail stuurt.
5. Vragen over je doel en teamgrootte mag je overslaan (Skip). Kies het gratis plan (Free).

Deze waarde: nu meteen in onze 1Password, item GitHub. Daarna verder.

Stap 2. Zet de tweede stap aan, per sms

GitHub vraagt om een tweede stap bij het inloggen. Die gaat naar je eigen telefoon, per sms. Omdat je na vandaag niet meer op GitHub inlogt, merk je daar verder niets van.

1. Klik rechtsboven op je profielfoto → Settings → Password and authentication → Two-factor authentication → Enable.
2. Kies SMS/Text message, vul je mobiele nummer in, en typ de code over die je per sms krijgt. Wat je ziet: een veld voor je nummer, en daarna een veld voor de code uit de sms.
3. GitHub toont herstelcodes (recovery codes): daarmee kom je erin als je je telefoon kwijt bent. Die zijn van jou. Zet ze in je eigen 1Password, in je kluis Private: op 1password.com, waar je in onderdeel 1 bent ingelogd, of in de app op je telefoon. Verwijder het gedownloade bestand daarna uit Downloads en de prullenbak.

Staat aan: de tweede stap per sms. Bij mij, niet bij Canoniek: mijn herstelcodes.

Stap 3. Maak de sleutel voor je Mac-server

Met deze sleutel zetten wij bij de installatie je opslag neer en werken je agenten daarna met je opslag, zonder dat iemand nog op GitHub hoeft in te loggen.

Klik hier: github.com/settings/tokens → Generate new token → Generate new token (classic). Vraagt GitHub om je wachtwoord of de code uit een sms, geef die dan.

1. Note: Canoniek Mac-server.
2. Expiration: No expiration. GitHub laat je dan een waarschuwing zien; die klopt voor gewone sleutels, maar deze sleutel moet blijven werken zolang je systeem draait.
3. Vink aan: repo, read:org en gist. Wat je ziet: een lijst met rechten, met bij elk recht een vakje.
4. Generate token. GitHub toont de sleutel maar één keer.
5. Kopieer hem meteen naar onze 1Password, kluis <klantnaam>, in het item GitHub: item bewerken → nieuw veld van het type wachtwoord, met de naam token → de sleutel plakken → opslaan.

Deze waarde: nu meteen in onze 1Password, item GitHub, veld token. Daarna het venster dicht.

Staat in onze 1Password: de sleutel voor mijn Mac-server.

Stap 4. Geef ons je gebruikersnaam, precies

1. Klik rechtsboven op je profielfoto. Bovenaan het menu staat je gebruikersnaam.
2. Open je profiel (Your profile). In de adresbalk staat github.com/ gevolgd door je gebruikersnaam. Kopieer de naam uit de adresbalk; typ hem niet over. Eén verkeerde letter en wij nodigen de verkeerde persoon uit.
3. Plak de naam in het item GitHub in onze 1Password, in het veld gebruikersnaam.

Staat in onze 1Password: mijn exacte gebruikersnaam.

Klaar met dit onderdeel

Door naar onderdeel 5, Plaud.

Wat er bij de installatie gebeurt. Daar hoef je niet bij te zijn. Je krijgt van GitHub een mail dat wij je uitnodigen voor onze blauwdruk: de opslag van ons waaruit jouw systeem wordt opgebouwd. Daar hoef je niets mee: met de sleutel uit stap 3 nemen wij die uitnodiging voor je aan, zetten we je eigen opslag neer, op jouw naam, en geven we ons leestoegang, zodat wij kunnen meekijken als er iets te repareren is.

← Terug naar het overzicht