Come creare un account GitHub e il tuo primo repository

Un repository GitHub è una cartella tracciata da Git. Ogni modifica ai suoi file viene salvata come commit, così puoi leggere la cronologia in seguito e vedere cosa è cambiato. Questa lezione mostra come creare un account e un repository e fare due commit, tutto dal browser. Non servono basi di programmazione né strumenti di sicurezza.

#Cosa ti serve

• Un indirizzo email a cui hai accesso.
• Un nome utente che ti va bene rendere pubblico.
• Un browser web. Per questa lezione non devi installare nulla.

#1. Crea il tuo account

Vai su github.com e segui la procedura di registrazione sul sito. Usa una password unica, meglio se salvata in un password manager. Poi attiva l'autenticazione a due fattori nelle impostazioni di sicurezza dell'account. La guida ufficiale alla 2FA elenca i metodi disponibili per il secondo fattore. L'SMS è disponibile solo in alcuni paesi.

L'interfaccia di GitHub cambia nel tempo. Se un'etichetta qui sotto non corrisponde a quello che vedi, usa come riferimento la guida Hello World.

#2. Crea un repository

Apri il menu di creazione nell'angolo in alto a destra e scegli New repository. La guida ufficiale descrive questi campi:

• Owner: il tuo account personale.
• Name: fino a 100 caratteri, con lettere ASCII, cifre e i caratteri ., - e _.
• Description: un breve riepilogo facoltativo.
• Visibility: pubblica o privata.
• File iniziali: README, .gitignore e licenza, tutti facoltativi.

Usa il nome security-learning-notes, aggiungi una breve descrizione e scegli Private mentre impari. Spunta l'opzione per aggiungere un README, poi crea il repository.

La visibilità privata limita chi può vedere il repository. Non lo rende un posto sicuro per password o chiavi, come spiega la sezione 6.

#3. Modifica il README

Apri README.md e clicca sull'icona della matita per modificarlo nel browser. Sostituisci il contenuto con qualcosa di specifico:

# My Security Learning Notes

This repository contains exercises I created while learning cybersecurity.

## Topics
- How DNS works
- Encoding versus encryption

## Scope
All exercises use local labs or systems I own.

Scrivi un breve messaggio che descrive la modifica, come Document learning goals, e fai il commit. Un commit è una modifica salvata con un messaggio e un timestamp. GitHub lo conserva nella cronologia del repository.

#4. Aggiungi un secondo file e fai il commit

Scegli Add file, poi Create new file. Scrivi notes/first-lesson.md nel campo del nome. Scrivendo una barra crei una cartella. Nel corpo, scrivi un paragrafo che spiega la differenza tra l'hash di una password e la cifratura. Un hash è un'impronta a senso unico dei dati, usata per controllare un valore senza conservare il valore stesso. La cifratura può essere invertita da chiunque abbia la chiave. Fai il commit di questo file con un suo messaggio, come Add first lesson notes.

Commit separati rendono la cronologia più facile da leggere. Ogni commit dovrebbe descrivere una sola idea.

#5. Leggi la cronologia

Apri la cronologia dei commit del repository. Dovresti vedere almeno due commit con messaggi comprensibili. Saper spiegare cosa è cambiato e perché conta più del numero di commit.

Se sul tuo computer c'è Git, la stessa cronologia è disponibile dalla riga di comando. Ho eseguito questo comando su un repository di prova con un solo commit e lo stesso messaggio:

git log --oneline

Output di quell'esecuzione:

03c208a Document learning goals

Il tuo hash sarà diverso. Su Windows, durante il primo commit Git può anche stampare un avviso sui fine riga. L'avviso non cambia il commit.

#6. Tieni i segreti fuori dal repository

Prima di caricare qualsiasi file, controlla che non ci siano file .env, token di accesso, dati di clienti, credenziali cloud o log privati. Un file .gitignore dice a Git di ignorare i file corrispondenti, e questo aiuta a prevenire gli incidenti. Non rimuove un segreto già finito in un commit, perché il vecchio commit resta nella cronologia.

Un esempio di .gitignore per un progetto di studio:

.env
*.pem
*.log

Se fai per sbaglio il commit di un segreto, prima di tutto revocalo o ruotalo. Una volta revocato o ruotato, il vecchio valore non dà più accesso, quindi riscrivere la cronologia può non valere la fatica. La guida di GitHub sulla rimozione dei dati sensibili tratta entrambi i passaggi, compresi gli effetti collaterali di una riscrittura.

#7. Errori comuni

• Incollare un token nel README per provarlo.
• Dare per scontato che un repository sia privato senza controllare l'impostazione di visibilità.
• Caricare un vero file di un cliente per fare pratica. Usa invece dati sintetici.
• Mettere in un solo commit molte modifiche scollegate. Dividi il lavoro in commit più piccoli.

#8. Cosa imparare dopo

Un repository gestito dal browser è utile per capire struttura e cronologia. Il passo successivo è imparare cosa fa Git sulla tua macchina, poi come git clone crea una copia locale di un repository su cui lavorare in sicurezza.

Tieni in questo repository solo appunti ed esercizi che ti andrebbe bene mostrare a chiunque.