Gå til indhold
Dokumentation sslbrain sslbrain.com

Når noget ikke virker

Kopiér link til siden “Når noget ikke virker”

Hvert afsnit starter med det, appliancen viser. Løser afsnittet det ikke, så send et supportbundt til FairSSL.

Appliancen kan ikke åbne sine nøgler

Kopiér link til afsnittet “Appliancen kan ikke åbne sine nøgler”

Det ser I: Efter en genstart giver login med sslbrain Cloud “Cloud-godkendelse er ikke tilgængelig. Prøv igen eller brug nødadgang.”

Årsag: Vault’en med certifikaternes private nøgler åbnes med en nøgle fra sslbrain Cloud, og appliancen kan ikke nå sslbrain Cloud. Cloud-forbindelse under Appliance og licens › Oversigt viser det.

Sådan løser I det: Få forbindelsen tilbage, se sslbrain Cloud kan ikke nås. Vault’en åbner derefter af sig selv.

Skal I ind før, så klik på Mistet adgang? Brug backup-ord på login-siden. Skriv de 12 backup-ord i Backup-ord, og klik på Log ind med backup-ord. I er nu logget ind som Admin Local, se Sikkerhed. Forkerte ord giver “Invalid backup key.”

Installationen er låst

Kopiér link til afsnittet “Installationen er låst”

Det ser I: Hver side viser Installationen er låst med knapperne Prøv at genoprette forbindelsen og Brug backup-nøgle i stedet.

Årsag: sslbrain Cloud har set en anden maskine melde sig som den samme installation, typisk en kopi af den virtuelle maskine. Eller appliancen er gendannet fra en backup. Vault’en er låst.

Sådan løser I det:

  1. Kører der en kopi af appliancen, fx en klon i hypervisoren, så sluk den.

  2. Klik på Brug backup-nøgle i stedet.

  3. Skriv de 12 backup-ord i Backup-nøgle med mellemrum imellem, og klik på Lås op.

Appliancen viser Overblik med “Vault oplåst.” Forkerte ord giver “Ugyldig nødnøgle.”

Installationen er pensioneret

Kopiér link til afsnittet “Installationen er pensioneret”

Det ser I: Installationen er pensioneret og “sslbrain Cloud betjener ikke længere den her appliance. …”

Årsag: Licensen er flyttet til en anden appliance.

Sådan løser I det: Brug den appliance, der har licensen nu. Skal I have data fra denne, så åbn den med Brug backup-nøgle i stedet. Se Flyt eller genopret appliancen.

Appliancen afventer bekræftelse

Kopiér link til afsnittet “Appliancen afventer bekræftelse”

Det ser I: Siden Afventer bekræftelse med Anmodnings-ID, Udløber og Sidst kontrolleret.

Årsag: Nogen har klikket på Prøv at genoprette forbindelsen på siden Installationen er låst. Appliancen venter på en beslutning i sslbrain Cloud. Anmodningen udløber efter 7 dage.

Sådan løser I det: Klik på Tilbage til låst tilstand og derefter på Brug backup-nøgle i stedet. Lås op med de 12 backup-ord. Har I ikke selv bedt om at genoprette forbindelsen, så kontakt FairSSL på info@fairssl.dk.

sslbrain Cloud kan ikke nås

Kopiér link til afsnittet “sslbrain Cloud kan ikke nås”

Det ser I:

  • Cloud-forbindelse står på Ikke forbundet under Appliance og licens › Oversigt.
  • Login-siden: “Cloud-godkendelse er ikke tilgængelig. Prøv igen eller brug nødadgang.”
  • Opdateringer: “Opdateringskontrollen kunne ikke nå sslbrain Cloud. Kontrollér cloud-forbindelsen.”
  • Handlinger på Overblik, efter 48 timer: Kan ikke kontrollere for opdateringer.

Årsag: En firewall, en proxy eller DNS stopper udgående HTTPS (443) til cloud.sslbrain.com, acme.sslbrain.com og registry.sslbrain.com.

Sådan løser I det: Vælg 2 Test the connection to sslbrain Cloud i konsolmenuen.

  • NAME DOES NOT RESOLVE: ret DNS-serverne under 3 Configure the network, se Konsolmenu.
  • NO ANSWER: som regel en firewall. Åbn udgående 443 til de tre navne.

Kører appliancen i Docker, så test fra værten:

Terminal window
curl -sS -o /dev/null -w '%{http_code}\n' https://cloud.sslbrain.com/api/v1/health

Imens virker certifikaterne på serverne til deres udløb. Login med lokal adgangskode virker, og det gør login for en Cloud-bruger, der har logget ind med adgangskode før, se Brugere og login. Alarmer gennem E-mail (SMTP) og Webhook virker, se Hold øje med certifikaterne. Certifikater, der bestilles gennem sslbrain Cloud, venter, til forbindelsen er tilbage.

En service-agent melder sig ikke

Kopiér link til afsnittet “En service-agent melder sig ikke”

Det ser I: “Agenten på … er offline” under Overvågning › Alarmer, eller “Agenten har ikke meldt sig i over et døgn.” på serverens side. Efter 48 timer også “Sidste check-in for … timer siden” under Handlinger og alarmreglen Agent inaktiv.

Årsag: Tjenesten er stoppet, serveren kan ikke nå appliancens adresse og port, eller appliancen har fået en anden adresse.

Sådan løser I det på en Linux-server: se status og log under Logfiler, og genstart med sudo systemctl restart sslbrain-agent.service.

På en Windows-server, i PowerShell som administrator:

Terminal window
Get-Service sslbrainagent
Test-NetConnection -ComputerName <appliance-adresse> -Port 443
Get-Content "C:\ProgramData\sslbrain\logs\agent-$(Get-Date -Format yyyy-MM-dd).log" -Tail 50
Restart-Service sslbrainagent
  • Tjenesten er stoppet: start den med Restart-Service sslbrainagent. Stopper den igen, så læs loggen, se Windows-servere.
  • TcpTestSucceeded er False: åbn udgående HTTPS fra serveren til appliancen. Har I valgt en anden Ekstern HTTPS-port end 443 under Netværk og DNS › Netværk, så test den.
  • Serveren står uden for jeres netværk: lad agenten forbinde via sslbrain Cloud, se Servere uden for jeres netværk.
  • Appliancen har fået en anden adresse eller port: giv agenterne den nuværende adresse, se Sådan når agenten appliancen.
  • Serverens side skriver “Appliancen er gendannet fra en backup. …”: agenten får arbejde igen, når den har svaret på appliancens udfordring, se Gem en backup, og gendan fra den.

En server uden agent kan ikke nås

Kopiér link til afsnittet “En server uden agent kan ikke nås”

Det ser I: Status Utilgængelig eller Auth fejlet under Servere, ”… svarer ikke” under Overvågning › Alarmer, eller alarmreglen Forbindelse tabt efter 2 timer.

Årsag: Appliancen forbinder selv til enheden over SSH eller enhedens API. Utilgængelig: enheden svarer ikke på porten. Auth fejlet: enheden afviser adgangsoplysningerne.

Sådan løser I det: Åbn serveren under Servere, og klik på Test forbindelse.

  • Utilgængelig: kontrollér, at enheden kører, og at appliancen kan nå den på port 22 for SSH eller enhedens HTTPS-port for API.
  • Auth fejlet: ret adgangsoplysningerne under Adgange, se Enheder uden agent.

Domænevalideringen fejler

Kopiér link til afsnittet “Domænevalideringen fejler”

Årsag: CA’en slår en TXT-record op under _acme-challenge.<navn> i offentlig DNS. sslbrain opretter den gennem CNAME viderestillingen til jeres Auto-DNS-navn eller med en DNS-API credential. Findes ingen af delene for navnet, bestilles certifikatet ikke.

Det ser I, og sådan løser I det:

  • “CA’en kunne ikke finde DCV-recorden i DNS. …”: kontrollér CNAME viderestillingen i offentlig DNS, se nedenfor.
  • ”… ikke har DNS-adgang til zonen. Opret en CNAME fra … til …”: opret den CNAME, beskeden nævner, se CNAME viderestilling.
  • ”… ingen DNS API credential dækker navnet. …”: opret en CNAME viderestilling eller en DNS-API credential for zonen, se DNS-API.
  • “DNS API credentialen kunne ikke oprette DCV-recorden for …”: klik på Test adgang ved credentialen. Ret nøglen eller rettighederne hos DNS-udbyderen.
  • “CA’en tager ikke imod flere bestillinger for de navne lige nu (rate limit). …”: vent, og prøv igen.
  • “Appliancen er ikke forbundet til sslbrain Cloud. …”: se sslbrain Cloud kan ikke nås.

Kontrollér CNAME viderestillingen mod en offentlig DNS-server:

Terminal window
dig @1.1.1.1 +short CNAME _acme-challenge.<domæne>
Terminal window
Resolve-DnsName -Server 1.1.1.1 -Type CNAME _acme-challenge.<domæne>

Svaret skal være Auto-DNS-navnet under Domænevalidering › CNAME viderestilling (Auto-DNS). En record, der kun findes i jeres interne DNS, ser CA’en ikke.

Et certifikat bliver ikke fornyet

Kopiér link til afsnittet “Et certifikat bliver ikke fornyet”

Det ser I: “Udløber om … dage” under Handlinger, alarmreglen Fornyelse fejlet, eller kilden står i Fejl under Kilder. sslbrain fornyer senest, når der er 7 dage tilbage, se Første certifikat på serveren.

Årsag og løsning:

  • Domænevalideringen fejler: se Domænevalideringen fejler.
  • Appliancen kan ikke nå sslbrain Cloud: se sslbrain Cloud kan ikke nås.
  • Kørslen står som “Sprunget over: mangler licens…”: licensen dækker ikke serverne, se Licensen er udløbet eller for lille.
  • Kilden står som “I kø, forventes kl. …”: kontoen har brugt sine bestillinger i døgnet hos sslbrains CA-konti. Bestillingen sendes automatisk på det viste tidspunkt, og appliancen henter certifikatet, så snart det er udstedt. I skal ikke gøre noget. Står der “I kø, udstedelse er sat på pause for kontoen”, så kontakt FairSSL support.
  • Certifikatet har ingen regel: opret en, se Første certifikat på serveren. Certifikater, I selv har uploadet, fornyes ikke af sslbrain.
  • Certifikatet er fornyet, men ikke installeret: se Installationen på serveren fejler.

Installationen på serveren fejler

Kopiér link til afsnittet “Installationen på serveren fejler”

Det ser I: “Fejlet deployment: …” under Handlinger, “Deploy fejlede på …” under Overvågning › Alarmer, eller alarmreglen Installation fejlet.

Årsag: Kørslens output siger hvorfor. Ofte melder agenten sig ikke, serveren kan ikke nås, eller kontoen på serveren mangler rettigheder.

Sådan løser I det:

  1. Åbn Udrulning › Kørsler, vælg Fejlede nu, og åbn kørslen.

  2. Ret årsagen. Melder agenten sig ikke, så se En service-agent melder sig ikke. Kan serveren ikke nås, så se En server uden agent kan ikke nås.

  3. Klik på Kør igen. Det kræver rollen Operator eller højere.

Installeres et fornyet certifikat ikke af sig selv, så kontrollér, at reglen er aktiv, og at Auto-deploy ved certifikatfornyelse er slået til. Har reglen et vedligeholdelsesvindue, installeres det først i vinduet. Se Første certifikat på serveren.

Login fejler

Kopiér link til afsnittet “Login fejler”
  • “E-mail eller adgangskode er forkert.”: forkert e-mail eller adgangskode. En Cloud-konto oprettet med GitHub, Google eller Microsoft har ingen Cloud-adgangskode. Brug Log ind med sslbrain Cloud.
  • “For mange loginforsøg. Prøv igen om … sekunder.”: mere end 30 forkerte forsøg. Vent det antal sekunder, beskeden nævner.
  • “Cloud-godkendelse mislykkedes. Prøv venligst igen.”: prøv igen.
  • “Cloud-godkendelse er ikke tilgængelig. …”: se sslbrain Cloud kan ikke nås.
  • “You do not have access to this installation.”: Cloud-kontoen er hverken ejer, administrator eller medlem af denne appliance. Giv personen adgang under Team i sslbrain Cloud, se sslbrain Cloud.
  • “Licensen på den her appliance tillader ikke flere logins. …”: alle licensens logins er brugt, se Brugere og login.
  • “Din session er udløbet. Log ind igen.”: en session varer 120 minutter. Log ind igen.

Kommer ingen ind, så klik på Mistet adgang? Brug backup-ord på login-siden, og brug de 12 backup-ord. Giv derefter en bruger en lokal adgangskode, så der er en vej ind uden sslbrain Cloud, se Brugere og login.

Opdateringen fejler

Kopiér link til afsnittet “Opdateringen fejler”

Det ser I: Opdateringslog under Vedligehold og support › Opdateringer viser “Fejlet: …” eller “Rullet tilbage: …”. Appliancen kører videre på den version, den havde.

Årsag i loggen, og sådan løser I det:

  • “der var ikke plads nok på disken …”: opdateringen kræver plads til den nye version (mindst 4 GB) plus 2 GB, se Disken er ved at være fuld.
  • “den nye version kunne ikke hentes”: appliancen kan ikke nå registry.sslbrain.com, se sslbrain Cloud kan ikke nås.
  • “signaturen kunne ikke verificeres”: prøv ikke igen. Send et supportbundt til FairSSL.
  • “den nye version kunne ikke starte” eller “den nye version svarede ikke korrekt efter start”: læs controllerens log i konsolmenuen under 4 View logs og derefter 2 The controller: updates, restarts, signature checks. Send et supportbundt til FairSSL.
  • “en docker-compose override på værten låser en anden image-version”: fjern image-linjen fra override-filen på værten, og opdatér igen.

Står der “Versionen er ikke signeret endnu og kan ikke installeres.”, så vent, og klik på Tjek nu senere. Se Hold sslbrain opdateret.

Licensen er udløbet eller for lille

Kopiér link til afsnittet “Licensen er udløbet eller for lille”

Det ser I: Licens udløber snart eller Licens udløbet under Handlinger, servere mærket Deaktiveret under Servere, eller en ny regel afvises med “Licensen omfatter ikke flere deploy-regler. …”

Årsag: En udløbet licens falder tilbage til Free, som dækker 5 servere og 10 regler. Licensen dækker de ældste servere. På resten bliver certifikaterne hverken fornyet eller installeret.

Sådan løser I det: Forny eller opgradér licensen under Licenser og units i sslbrain Cloud, se sslbrain Cloud. Eller slet servere, I ikke bruger længere, så får de næste i rækken licens.

Under den første opsætning:

  • “Kontoen har ingen ledig licens lige nu.”: køb en licens, eller frigør den, en anden appliance har, se Flyt eller genopret appliancen.
  • “Der findes allerede en gratis licens registreret på denne IP-adresse.”: der kan kun være én Free-licens pr. IP-adresse.

Disken er ved at være fuld

Kopiér link til afsnittet “Disken er ved at være fuld”

Det ser I: Lav plads på disken under Handlinger ved 80 %, og Kritisk lav plads på disken ved 90 %. Ved 90 % afvises backups og opdateringer, der ville fylde disken. Fornyelse af certifikater kører videre.

Årsag: Backups, appliancens versioner og logfiler ligger på samme disk.

Sådan løser I det:

  1. Hent de backups, I vil gemme, og slet gamle backups under System › Backup, se Gem en backup, og gendan fra den.

  2. Vælg 7 Free disk space i konsolmenuen. Den sletter ubrugte images, også den version af appliancen, der kørte før den nuværende.

  3. Er det ikke nok, så sluk den virtuelle maskine, gør den virtuelle disk større i hypervisoren, og start maskinen. Vælg derefter 9 Danger zone og 5 Claim new space from the virtual disk. Se Konsolmenu.

Kører appliancen i Docker, så frigør plads på værten.

Send et supportbundt til FairSSL

Kopiér link til afsnittet “Send et supportbundt til FairSSL”

Under Vedligehold og support › Support, i kortet Supportbundt, som kun administratorer ser:

  • Send til sslbrain Cloud sender bundtet til FairSSL, når I har bekræftet. Det kræver forbindelse til sslbrain Cloud.
  • Hent supportbundt henter filen sslbrain-debug-<dato>-<tid>.json. Send den til info@fairssl.dk.

Adgangskoder, tokens, API-nøgler og private nøgler fjernes fra bundtet. Hostnames og IP-adresser bliver i det. Hvad bundtet indeholder: Support og diagnostik.