Een zelfgehoste app oplossen die een oud geheim blijft gebruiken

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een zelfgehoste app blijft een oud geheim gebruiken wanneer de waarde die je hebt gewijzigd niet dezelfde is als de waarde die het actieve proces daadwerkelijk heeft geladen.

Op een thuisserver kunnen hetzelfde wachtwoord, dezelfde API-token of dezelfde coderingssleutel voorkomen in een Compose-omgeving, een env-bestand, een gekoppeld geheim bestand, een interface voor containerbeheer of de eigen permanente database van de toepassing. Alleen het proces herstarten is niet genoeg als de container niet opnieuw is aangemaakt, de app de configuratie intern opslaat of een tweede service zich nog met de oude inloggegevens aanmeldt. Volg het geheim van de bron tot het proces voordat je volumes verwijdert of het opnieuw roteert.

Bewijs dat de actieve container nog steeds de oude waarde heeft

Begin met het vaststellen van één veilige vingerafdruk van het geheim, in plaats van het geheim zelf weer te geven. Vergelijk de geconfigureerde bron, de omgeving van de actieve container of het gekoppelde geheime bestand, en het toepassingslogboek of de verbindingsfout die aantoont welke inloggegevens de toepassing probeert te gebruiken.

Een uitleg over het oplossen van Compose-problemen legt uit dat herstarten de oude configuratie behoudt, omdat bij het herstarten de bestaande containerconfiguratie wordt hergebruikt in plaats van een gewijzigde servicedefinitie te verwerken.

Als de actieve container al de nieuwe vingerafdruk toont, geef dan Docker-configuratie niet langer de schuld en zoek hogerop naar opslag in de toepassing of de externe dienst die het geheim controleert. Toont de container nog steeds de oude vingerafdruk, voer de reparatie dan op implementatieniveau uit.

Ga na welke bron voor geheimen de app daadwerkelijk uitleest

Breng alle mogelijke bronnen voor die inloggegevens in kaart: inline Compose-omgevingsvariabelen, .env, env_file, een gekoppeld bestand, een Docker- of Podman-geheim, een configuratiebestand van de toepassing, de gebruikersinterface van de containerbeheerder en elke installatiewizard die de waarde in permanente opslag heeft opgeslagen.

Een praktische handleiding voor Compose-configuraties maakt onderscheid tussen gekoppelde configuratiebestanden en geheimen, wat handig is als een bewerkt env-bestand niet de bron is die de toepassing momenteel uitleest.

Wijzig alleen de bron die voor deze implementatie gezaghebbend is. Als je drie kopieën tegelijk bewerkt, kan de app succesvol starten zonder dat duidelijk is welke verouderde bron het probleem veroorzaakte.

Maak de service opnieuw aan wanneer het geheim deel uitmaakt van de containerconfiguratie

Als de inloggegevens worden doorgegeven als omgevingsvariabele van een container of als geheim dat pas beschikbaar wordt wanneer de container wordt aangemaakt, maak de betreffende service dan opnieuw aan en behoud de persistente volumes. Alleen stoppen en starten kan ertoe leiden dat de oorspronkelijke containerdefinitie ongewijzigd blijft.

Een Podman-rotatievoorbeeld vermeldt dat het roteren van geheimen services bijwerkt nadat een geheim is vervangen. Daarmee is de levenscyclus van de container een afzonderlijke stap naast het bijwerken van de geheimenopslag.

Maak eerst alleen de consumer-service opnieuw aan. Verwijder geen benoemde volumes of databasemappen, tenzij de toepassing de verouderde inloggegevens daar expliciet opslaat en je een geverifieerde back-up hebt.

Single board computer zimaboard2

Controleer of opgeslagen app-configuratie de omgeving overschrijft

Sommige zelf gehoste apps behandelen omgevingsvariabelen als standaardwaarden voor de eerste start en slaan daarna een bewerkbare configuratie op in een database of toepassingsgegevensmap. In dat ontwerp kan de nieuwe omgevingswaarde correct zijn, terwijl de app bewust de opgeslagen waarde blijft gebruiken.

Een handleiding voor het oplossen van problemen met Open WebUI laat precies deze situatie zien: opgeslagen configuratie kan omgevingsvariabelen overschrijven totdat de opgeslagen instelling wordt gewijzigd of dat gedrag bewust wordt uitgeschakeld.

Controleer de ondersteunde beheerdersinstellingen of configuratiedatabase van de toepassing voordat je handmatig bestanden wijzigt. Als de nieuwe geheime waarde actief wordt door de opgeslagen instelling te wijzigen, leg dan vast dat die instelling de gezaghebbende bron is voor toekomstige rotaties.

Controleer of de app in plaats daarvan een geheim bestand laadt

Toepassingen kunnen terugvallen op een gegenereerd of gekoppeld geheim bestand als er geen omgevingsvariabele is. Daardoor kan het lijken alsof een container opnieuw is aangemaakt, terwijl het proces nog steeds een ouder bestand uit een persistent volume leest.

Een installatievoorbeeld van Open WebUI laat zien hoe de app bij latere starts een opgeslagen geheim bestand laadt. Dit illustreert waarom het actieve bestandspad onafhankelijk van het Compose YAML-bestand moet worden gecontroleerd.

Controleer het pad, de wijzigingstijd, de eigenaar en een veilige vingerafdruk van het bestand. Vervang het alleen via de door de toepassing ondersteunde methode, omdat coderingssleutels en ondertekeningsgeheimen sessies ongeldig kunnen maken of reeds versleutelde gegevens onleesbaar kunnen maken.

Roteer de gebruiker en provider als één transactie

Een databasewachtwoord, API-token of service-inloggegeven heeft twee kanten: de app die het opgeeft en de provider die het verifieert. Als u slechts één kant bijwerkt, ontstaat er een verificatiefout die kan worden aangezien voor het in de cache bewaren van een oude waarde door de app.

Een workflow voor het vernieuwen van geheimen laat zien dat toepassingen vernieuwde geheimen opnieuw moeten laden via een herstart, signaal of toepassingsspecifiek herlaadgedrag, in plaats van ervan uit te gaan dat het proces elke bestandswijziging automatisch opmerkt.

Voer één echte geauthenticeerde actie uit, start de service nogmaals opnieuw of maak deze opnieuw aan en test opnieuw. De reparatie is voltooid wanneer de nieuwe inloggegevens na het opnieuw aanmaken behouden blijven en de oude inloggegevens worden geweigerd. De gerelateerde ZimaSpace-gids over een zelfgehoste app met een falend API-pad is de volgende stap wanneer het nieuwe geheim is geladen, maar verzoeken nog steeds mislukken.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.