Waarom een tijdelijke stopzetting toegang kan achterlaten
Wanneer je een integratie snel wilt pauzeren, is opschorten of verwijderen de voor de hand liggende stap. Dat regelt de installatiekant. Het regelt niet automatisch de autorisatiekant, die een andere verlening is met een andere eigenaar.
Het opschorten van een geïnstalleerde GitHub App blokkeert tijdelijk de toegang tot resources die eigendom zijn van dat installatieaccount. Bron
Dat onderscheid is belangrijk omdat een GitHub App tegelijkertijd twee soorten toegang kan hebben: installatietoegang tot de resources van een account, en gebruikersautorisatie om namens een persoon te handelen. Het pauzeren van het een pauzeert het ander niet.
Opschorting verwijdert niet de afzonderlijke autorisatie voor een app om namens een gebruiker te handelen. Bron
Installatietoegang versus gebruikersautorisatie
Gebruik deze tabel om te bepalen welk oppervlak je daadwerkelijk moet wijzigen.
| Wat je wilt stoppen | Te controleren oppervlak | Wat opschorting doet | Wat het niet doet |
|---|---|---|---|
| Dat de app resources bereikt die eigendom zijn van het installerende account | De installatie op dat account | Blokkeert tijdelijk de toegang van die installatie | De gebruikersautorisatie verwijderen |
| Dat de app namens een persoon handelt | Geautoriseerde GitHub Apps voor die gebruiker | Op zichzelf niets | De autorisatie op gebruikersniveau stoppen |
| Beide, voor één account | Beide oppervlakken | Dekt alleen de installatiekant | Laat de andere verlening staan |
Een GitHub App is geen actieve browsersessie waar je zomaar uit kunt loggen. Een installatie opschorten is een controle op accountniveau over resources; deautorisatie is een controle op gebruikersniveau over gedelegeerde acties. Ze worden afzonderlijk beheerd en moeten afzonderlijk worden geverifieerd.
Een praktische checklist voor een tijdelijke stopzetting
- Benoem eerst het doel. Bepaal of je het bereik van de app tot de resources van een account pauzeert, of je stopt dat de app namens een gebruiker handelt, of beide. Het antwoord bepaalt welk oppervlak je aanraakt.
- Regel de installatie. Schort de installatie op bij het account dat eigenaar is van de resources die je wilt beschermen. Behandel dit als tijdelijk en omkeerbaar.
- Controleer de gebruikerskant afzonderlijk. Als de app gemachtigd was om namens jou te handelen en je wilt dat stoppen, ga dan naar Geautoriseerde GitHub Apps en deautoriseer de app daar. Ga er niet van uit dat de opschorting dit heeft gedekt.
- Leg vast wat je hebt gewijzigd en waar. Noteer van welk account je de installatie hebt opgeschort en welke gebruikersautorisatie je eventueel hebt verwijderd. Zo mist een latere opruiming niet een van de twee.
- Draai het bewust terug. Als de pauze tijdelijk was, schakel de installatie pas weer in nadat je hebt bevestigd of de gebruikersautorisatie ook moet worden hersteld.
Verwijderen is ingrijpender dan opschorten, maar nog steeds afgebakend
Als een tijdelijke pauze niet genoeg is en je wilt dat de installatie verdwijnt, is verwijderen de sterkere actie aan de installatiekant. Het bereikt op zichzelf nog steeds niet de gebruikersautorisatie.
Verwijderen haalt de installatietoegang van dat account weg; deautorisatie in Geautoriseerde GitHub Apps is een afzonderlijke actie wanneer de eigenaar wil stoppen dat de app namens hen handelt. Bron
De praktische consequentie: controleer na het verwijderen Geautoriseerde GitHub Apps als de eigenaar ook wil dat de app stopt met namens hen handelen. Het verwijderen van de ene verbinding is geen bewijs dat de andere weg is, en een app die niet meer op de ene plek verschijnt, kan nog steeds de andere verlening hebben.
Veelvoorkomende foutpaden
- Aannemen dat opschorten een volledige intrekking is. Het blokkeert alleen de resourcetoegang van de installatie. De gebruikersautorisatie blijft bestaan tot je die aanpakt.
- Deautorisatie aanzien voor verwijdering. Deautoriseren stopt dat de app namens jou handelt, maar de installatie op een account kan blijven bestaan. Bepaal welke van de twee je stopzetting echt vereist.
- Het ene account opruimen en het andere vergeten. Installaties horen bij accounts; autorisaties horen bij gebruikers. Een stopzettingsplan dat maar één oppervlak noemt, laat het andere meestal ongemoeid.
- Te vroeg weer inschakelen. Als je hebt opgeschort in plaats van verwijderd, kan het herstellen van de installatie de resourcetoegang herstellen voordat je de gebruikerskant hebt beoordeeld.
Beide oppervlakken verifiëren voordat je het af noemt
Een stopzetting is pas compleet wanneer elk oppervlak dat je wilde wijzigen op zijn eigen voorwaarden is gecontroleerd. Bevestig de installatiestatus op het eigenaarsaccount en bevestig daarna de autorisatiestatus onder Geautoriseerde GitHub Apps voor de betreffende gebruiker. Leid het ene niet af uit het andere, en beschrijf de app niet als uitgelogd — het was nooit een browsersessie.
Als je volgende taak het verwijderen van een oudere OAuth-verlening is en je dat gescheiden wilt houden van inlogsessies, dan behandelt de gerelateerde gids over een oude GitHub OAuth-app intrekken zonder die te verwarren met een inlogsessie die andere opruimstap.