Naar de inhoud springen
Geverifieerd

SSH-toegang voor ontwikkelaars

SSH-sleutels van het account, welke servers ze kunnen bereiken en kortlevende tokens om met er een te verbinden.

Een door Xuda beheerde server via SSH bereiken heeft drie lagen: de sleutels die je account bezit, welke daarvan een bepaalde server accepteert en een kortlevend, intrekbaar token dat de verbinding echt opent. Elke verbinding loopt als tunnel via Xuda. Niets hier geeft je het eigen adres van de server rechtstreeks.

Een sleutel aan je account toevoegen

Instellingen > Beveiliging > SSH-sleutels bevat elke publieke sleutel die je account aan een server kan aanbieden. Elke sleutel is één regel: zijn naam, het type en het einde van de sleutel, wanneer hij is toegevoegd, hoeveel servers hij opent en één status: Aan, Uit, Verloopt binnenkort, Verlopen of Geen server.

Maak een sleutelpaar, als je er nog geen hebt

Terminal
ssh-keygen

Accepteer de standaardlocatie van het bestand en stel eventueel een wachtwoordzin in. Dit maakt twee bestanden: een privésleutel die je zelf houdt en een .pub-bestand dat je deelt.

De publieke sleutel toevoegen

Druk op SSH-sleutel toevoegen (bij een account zonder sleutels opent het formulier meteen). Plak in het formulier Nieuwe SSH-sleutel de inhoud van het .pub-bestand in Inhoud SSH-sleutel, geef hem een Sleutelnaam en druk op Sleutel toevoegen. De sleutel wordt gecontroleerd terwijl je plakt, dus een privésleutel, een regel die geen publieke sleutel is of een opmerking zonder @ wordt bij naam genoemd voordat je iets toevoegt. Een Vervaldatum (optioneel) kan vandaag of later zijn. Laat hem leeg voor een sleutel die nooit verloopt. De nieuwe sleutel opent dan op zijn plaats, gemarkeerd als Geen server: niemand kan hem gebruiken tot je zijn servers kiest (zie het volgende onderdeel).

Een sleutel beheren

Druk op de rij van een sleutel om hem op zijn plaats te openen. Er is één sleutel tegelijk open. De geopende sleutel toont zijn status, de sleutel met zijn vervaldatum en het aantal dagen tot die datum. Een sleutel die je aandacht nodig heeft, opent vanzelf: een sleutel die is verlopen maar nog op een server staat, anders de sleutel op een server die het eerst verloopt binnen 14 dagen. In de geopende sleutel:

  • Bewerken wijzigt de naam en de vervaldatum van de sleutel. De sleutel zelf is alleen-lezen: voeg een nieuwe sleutel toe om hem te wijzigen. Bij een sleutel die als Verloopt binnenkort is gemarkeerd luidt de knop Vervaldatum verlengen, en bij een verlopen sleutel Nieuwe vervaldatum instellen. Beide zijn dezelfde bewerking, geopend bij de datum. Wissen naast de datum verwijdert de vervaldatum.
  • De schakelaar Toegang zet de sleutel uit zonder hem te verwijderen, waardoor hij in één keer van elke server wordt gehaald waarop hij is geïnstalleerd. Een server die niet bereikbaar is, houdt de sleutel, en de regel onder de schakelaar zegt hoeveel servers niet reageerden, zodat je het opnieuw kunt proberen. Een sleutel weer aanzetten installeert hem niet opnieuw: voeg hem opnieuw toe op elke server.
  • Verwijderen vraagt je te bevestigen, haalt de sleutel dan van elke server die hij opent en verwijdert hem. Als een server niet reageert, wordt de sleutel niet verwijderd.

Het Toegangslogboek, de laatste rij onder je sleutels, opent op zijn plaats en toont elke toekenning, verwijdering en vervaldatum op het account, nieuwste eerst: zes gebeurtenissen, daarna Alles tonen voor de rest (in totaal de laatste 500). Activiteit voor deze sleutel, in een geopende sleutel, opent hetzelfde logboek voor alleen die sleutel, en Alle sleutels verbreedt het weer naar het account.

Vervaldatum

Een sleutel binnen 14 dagen voor zijn vervaldatum toont Verloopt binnenkort zolang hij op een server staat. Na de datum toont hij Verlopen. Voordat zijn datum voorbij is, toont een sleutel die uit staat Uit en een sleutel op geen enkele server Geen server. Verlopen sleutels worden elk uur van hun servers gehaald. Zet een verlopen sleutel uit om hem nu te verwijderen. Zodra hij van zijn servers af is, heeft hij geen schakelaar meer: geef hem een nieuwe datum met Nieuwe vervaldatum instellen en voeg hem dan opnieuw toe aan een server. Een verlopen of uitgezette sleutel kan niet nieuw aan een server worden toegewezen, maar een al toegewezen sleutel verwijderen werkt nog wel.

Kiezen welke server een sleutel kan bereiken

Een sleutel aan je account toevoegen geeft hem op zichzelf nergens toegang toe, en het eigen scherm van de sleutel toont hoeveel servers hij opent, niet welke. Open het tabblad Geavanceerd van een VPS, beheerde VPS, datacenter of deployment en druk op Sleutels toewijzen, op de rij SSH-sleutels onder Up-to-date houden, om te kiezen welke sleutels van je account die specifieke server mogen bereiken.

Opslaan vergelijkt je selectie met wat was geïnstalleerd toen je de keuzelijst opende: nieuw aangevinkte sleutels worden eerst geïnstalleerd, daarna worden uitgevinkte verwijderd, zodat een sleutel die de server weigert (omdat hij uit staat of is verlopen) nooit toegang kan weghalen die al werkte. Een uitgezette of verlopen sleutel wordt in de keuzelijst als zodanig getoond en kan niet nieuw worden geselecteerd.

Verbinden met de server

Open het project en druk op Verbinden op de rij Veilig SSH (alleen projecten uit de VPS-familie) om Toegang voor ontwikkelaars te openen, een beheerder voor benoemde, intrekbare verbindingstokens, los van de accountsleutels hierboven.

Een benoemde toegang aanmaken

Druk op Toegang toevoegen, geef hem een label (voor wie of wat hij is) en eventueel een vervaldatum (7, 30, 90 of 365 dagen, of nooit). Aanmaken toont een eenmalig verbindingstoken: kopieer het nu, het kan niet opnieuw worden getoond.

De client installeren en verbinden

Het venster geeft per platform (macOS, Linux, Windows) een installatiecommando en een verbindingscommando om te kopiëren en plakken, opgebouwd rond websocat, dat de verbinding als tunnel naar een poort op je eigen machine stuurt. Richt een willekeurige SSH- of SFTP-client op dat lokale adres zodra de tunnel draait, en log in als root.

Het daarna beheren

Elke benoemde toegang heeft een eigen schakelaar om op te schorten. Opschorten, een vervaldatum laten verstrijken of een toegang verwijderen wordt op de tunnel zelf afgedwongen en sluit een sessie die al bezig is. Opnieuw genereren maakt een vers token voor een bestaande toegang en maakt het oude ongeldig. Het roteert nooit automatisch, omdat dat iedereen zou afsnijden die het nog gebruikt. Een toegang verwijderen vraagt eerst om bevestiging.

Permission denied (publickey)

Een verbindingspoging mislukt met deze fout als er nog geen accountsleutel aan die server is toegewezen. Voeg een sleutel toe onder Instellingen > Beveiliging > SSH-sleutels en wijs hem aan de server toe voordat je het opnieuw probeert.