Logging

FoxIDs registreert standaard waarschuwingen, fouten, kritieke fouten en gebeurtenissen. Logboekvermeldingen bevatten een tijdstempel en relevante verzoek- of identiteitscontext, zoals het IP-adres van de client, indien beschikbaar. Aanvullende traces en statistieken kunnen per omgeving worden ingeschakeld voor diagnostische doeleinden.

Logbestemmingen

Stel de logbestemming in met Settings__Options:Log. FoxIDs ondersteunt drie opties:

• Stdout schrijft logbestanden naar de console-uitvoer. Dit is geschikt voor implementaties op Docker en Kubernetes, waarbij het hostingplatform de consolelogbestanden verzamelt.
• OpenSearchAndStdoutErrors schrijft doorzoekbare logbestanden naar OpenSearch en schrijft fouten naar de console-uitvoer. Dit wordt vaak gebruikt voor implementaties op Kubernetes.
• ApplicationInsights verzendt doorzoekbare logbestanden naar Azure Application Insights. Dit wordt vaak gebruikt voor Azure-implementaties.

FoxIDs Control kan logbestanden, gebruiks- en auditgegevens doorzoeken wanneer OpenSearchAndStdoutErrors of ApplicationInsights is geconfigureerd. Bij Stdout maakt u gebruik van de logboekfuncties die door het hostingplatform worden aangeboden.

Stdout-indeling en minimumniveau

FoxIDs gebruikt de standaardconfiguratie voor .NET Console-logging onder Logging:Console voor uitvoer die naar stdout wordt geschreven. De eenvoudige tekstformatter wordt gebruikt tenzij een andere formatter is geconfigureerd. De meegeleverde Kubernetes-deployment selecteert de JSON-formatter, zodat elke logboekvermelding als één gestructureerde regel kan worden verzameld.

Met de JSON-formatter wordt de logtekst naar Message geschreven, worden contextuele eigenschappen zoals RequestId, RequestPath, tenant en omgeving als afzonderlijke velden onder State geschreven en worden details van uitzonderingen naar Exception geschreven. Metrics bevatten ook een numerieke State.Value. JSON-vermeldingen gebruiken standaard UTC-tijdstempels in de indeling yyyy-MM-ddTHH:mm:ss.fffZ. De eenvoudige formatter behoudt de tekstweergave over meerdere regels.

Stel de JSON-formatter in met een omgevingsvariabele:

Logging__Console__FormatterName=json

De standaardwaarden voor het tijdstempel kunnen worden overschreven via de standaardopties van de formatter, bijvoorbeeld:

Logging__Console__FormatterOptions__TimestampFormat=yyyy-MM-ddTHH:mm:ssZ
Logging__Console__FormatterOptions__UseUtcTimestamp=true

Het minimumniveau van Console-logging is standaard Trace, zodat alle logboektypen behouden blijven die in de logboekinstellingen van de FoxIDs-omgeving zijn ingeschakeld. Je kunt het minimumniveau onafhankelijk per deployment verhogen, bijvoorbeeld:

Logging__Console__LogLevel__Default=Information

Het minimumniveau beïnvloedt de stdout-uitvoer als volgt:

Het minimumniveau van Console-logging is een aanvullend filter. Het schakelt geen traces of metrics in die zijn uitgeschakeld in de logboekinstellingen van de omgeving.

Logboeken in FoxIDs Control

Open Logs in de FoxIDs Control Client om te schakelen tussen operationele logboeken, gebruiksgegevens, auditverslagen en instellingen voor omgevingslogboeken.

Logboeken

Op het tabblad Logs kunt u zoekopdrachten uitvoeren in operationele logboekvermeldingen. Selecteer het tijdsbereik en de logboektypen, en voer eventueel zoektekst in om de resultaten te verfijnen. Fouten en waarschuwingen zijn standaard geselecteerd. In een reguliere omgeving zijn gebeurtenissen ook standaard geselecteerd, terwijl traces en metrics beschikbaar zijn wanneer deze zijn ingeschakeld in de logboekinstellingen van de omgeving.

Verzoeken die vóór de routering naar tenant en omgeving worden afgewezen, worden geclassificeerd als afgewezen verzoeken en uitgesloten van reguliere gebeurtenissen. Selecteer in de master-tenant afgewezen verzoeken om ze te onderzoeken op verzoekpad, HTTP-methode en beschikbare verzoekcontext. Afgewezen verzoeken zijn niet beschikbaar in andere tenants.

Gerelateerde vermeldingen zijn gegroepeerd op volgorde en bewerking, zodat u een authenticatiestroom kunt volgen of een verzoek kunt opvragen en de bijbehorende gebeurtenissen, contextuele eigenschappen en uitzonderingen kunt bekijken.

Gebruik

Het tabblad Gebruik geeft een overzicht van de activiteiten voor een geselecteerde tijdsperiode en interval. U kunt authenticatiemethoden, gebruikers, aanmeldingen, tokenverzoeken, aanvullende bewerkingen en Control API-aanroepen opnemen.

Het geselecteerde beheerbereik bepaalt welk gebruik wordt weergegeven:

• In een reguliere omgeving bevat het resultaat het gebruik voor die omgeving.
• In de masteromgeving van een tenant bevat het resultaat het gebruik voor de gehele tenant en kan dit worden beperkt tot een bepaalde omgeving.
• In de masteromgeving van de master-tenant bevat het resultaat het gebruik voor de volledige FoxIDs-implementatie en kan dit worden beperkt tot een tenant en een omgeving.

Auditlogboeken

Op het tabblad Audit worden beveiligingsrelevante gebruikersactiviteiten en beheerwijzigingen vastgelegd. Zoeken in auditlogboeken is beschikbaar met OpenSearchAndStdoutErrors en ApplicationInsights; dit is niet beschikbaar wanneer de logbestemming Stdout is.

Selecteer een periode van maximaal zeven dagen en voer desgewenst zoektekst in. Een zoekopdracht retourneert maximaal 300 van de nieuwste overeenkomende records en toont een waarschuwing wanneer het resultaat is afgekapt. De zoektekst wordt vergeleken met de gebeurtenisnaam, het audittype, de actie, gebruikersidentificaties, de authenticatiemethode, de registratie- of document-ID, tenant, omgeving en gewijzigde gegevens.

Auditrecords gebruiken de volgende typen:

Elk record toont het audittype en de beschikbare context. Gebruikersactiviteiten kunnen de gebruikers-ID, het e-mailadres, telefoonnummer, de gebruikersnaam, sessie-ID en authenticatiemethode bevatten. Alleen identificaties die beschikbaar zijn in de aanmeldingsclaims of sessie worden vastgelegd. Een registratie van een authenticator-app bevat ook de RegistrationId.

Voor een Data-record geeft DataType het soort configuratiegegevens aan, identificeert DocumentId het betreffende item en is Action Create, Update, Save of Delete. De opgemaakte JSON-gegevens tonen waar van toepassing de gewijzigde waarden met before- en after-waarden. Gevoelige eigenschappen zoals geheimen, hashes, nonces en sleutels worden gemaskeerd.

Het geselecteerde beheerbereik bepaalt welke auditrecords kunnen worden doorzocht:

• In een normale omgeving bevat het resultaat records voor die omgeving.
• In de masteromgeving van een tenant bevat het resultaat records voor de tenant en kan het worden beperkt tot een bepaalde omgeving.
• In de masteromgeving van de mastertenant bevat het resultaat records voor de volledige FoxIDs-installatie en kan het worden beperkt tot een tenant en omgeving.

Logboekinstellingen

Open Logs > Instellingen om de diagnostische details te configureren die voor de geselecteerde omgeving worden vastgelegd:

• Log info trace registreert details over in- en uitlogprocedures.
• Log claim trace registreert de claims die zijn ontvangen en doorgestuurd of uitgegeven door authenticatiemethoden en applicatieregistraties.
• Log message trace registreert ontvangen en verzonden ruwe protocolberichten.
• Log metric registreert responstijden en doorvoercapaciteit.

Waarschuwingen, fouten, kritieke fouten en gebeurtenissen worden ongeacht deze instellingen nog steeds geregistreerd.

Claim- en berichttraces kunnen persoonsgegevens, tokens en andere gevoelige protocolinformatie bevatten. Schakel deze alleen in wanneer dit nodig is voor diagnostische doeleinden, beperk de toegang tot de logopslag en hanteer een passende bewaartermijn.

Logstream

Een logstream stuurt geselecteerde logtypen door naar een externe opslagplaats, onafhankelijk van de geconfigureerde primaire logbestemming. Voeg bijvoorbeeld een Azure-Application Insights-logstream toe en selecteer welke logtypen FoxIDs moet verzenden.

Gerelateerde documentatie

• Querylogboeken, audit en gebruik met de Control API- Monitoring en statuscontroles
• FoxIDs Control Client en API
• Implementatie van Kubernetes
• Implementatie in Azure
• Claimtransformaties en diagnostische claimtraces