Certificaten installeren in Persoonlijke locaties

Wanneer u uw Docker-gebaseerde Persoonlijke locatie instelt, moet u mogelijk certificaten installeren om vertrouwen te creëren en verbindingen te verifiëren met de website of webservice die u monitort.

De volgende types certificaten zijn beschikbaar voor installatie:

• Clientcertificaten (PKCS #12)
• Intermediate Certificate Authority (CA)-certificaten (PKCS #7)
• Root Certificate Authority (CA)-certificaten (PKCS #7)

Merk op dat het Uptrends Docker-gebaseerde installatie zip-bestand een Certificates-map bevat. Hierin vindt u submappen voor elk ondersteund certificaattype, waar certificaten kunnen worden geïnstalleerd zoals hieronder beschreven.

Certificaten installeren op een Docker-gebaseerde Persoonlijke locatie

Dit gedeelte is een optionele installatiehandleiding voor certificaten op Docker-gebaseerde Persoonlijke locaties. Deze stappen zijn alleen nodig als voor een van uw te testen applicaties de installatie van een certificaat vereist is.

Voordat u de cliëntcertificaten installeert, moet u ervoor zorgen dat u de installatiestappen voor Docker-gebaseerde Persoonlijke locaties heeft gevolgd.

Certificate Authority (CA)-certificaten installeren

CA-certificaten installeren:

1. Open de map die de installatie van uw persoonlijke locatie bevat. U vindt er standaard verschillende bestanden, zoals het YAML-bestand docker-compose en Windows PowerShell-scripts. Deze bestanden zijn essentieel voor het installatieproces.

2. Open de map Certificates. Deze map bevat drie submappen en een README Markdown-bestand.

3. Plaats uw CA-certificaten in de juiste Certificates-submappen:

• Intermediate-map — voor alle Intermediate Certificate Authority (CA)-certificaatbestanden (PKCS #7).
• Root-map — voor alle Root Certificate Authority (CA)-certificaatbestanden (PKCS #7).

4. Start de Uptrends-controlestationsoftware opnieuw op door het script update-images.ps1 uit te voeren vanuit de installatie-root directory.

Cliëntcertificaten installeren

Merk op dat Clientcertificaten in Multi-step API (MSA)-controleregels en Clientcertificaten voor Persoonlijke locaties niet gerelateerd zijn en voor verschillende doeleinden dienen.

Cliëntcertificaten installeren:

1. Open de map die de installatie van uw persoonlijke locatie bevat. U vindt er standaard verschillende bestanden, zoals het YAML-bestand docker-compose en Windows PowerShell-scripts. Deze bestanden zijn essentieel voor het installatieproces.

2. Open de map Certificates. Deze map bevat drie submappen en een README Markdown-bestand.

3. Plaats uw Clientcertificaat in de map Client.

4. Creëer in de map Client een JSON-bestand met de naam clientCertificates.json. Dit JSON-bestand moet al uw cliëntcertificaten bevatten. Ga anders verder met de volgende stap.

• Kopieer en bewerk de JSON-sjabloon om te beginnen:

[
    {
        "File": "my-first-client-cert.p12",
        "Password": "letmein",
        "UrlPatterns": ["https://fake.sub.domain.example.com"]
    },
    {
        "File": "AcmeCert.pfx",
        "Password": "anvil123",
        "UrlPatterns": ["https://client.acmecorp.fake:1234", "[*.]acmecorp.real"]
    }
]

Merk op dat het JSON-fragment uit twee Cliëntcertificaten bestaat. Elk Cliëntcertificaat wordt vertegenwoordigd door een JSON-object met drie paren keywaarden. Het eerste certificaat, my-first-client-cert.p12, kan alleen worden gebruikt voor een specifiek subdomein. Terwijl het tweede certificaat, AcmeCert.pfx, kan worden gebruikt voor het subdomein van de cliënt van acmecorp.fake bij verbinding met HTTPS-poort 1234, of bij bezoek aan acmecorp.real of een van de subdomeinen.

Bewerk de volgende waarden op basis van uw vereisten:

• File — de bestandsnaam en bestandsextensie van uw Cliëntcertificaat.
• Password — het wachtwoord dat nodig is om toegang te krijgen tot de data in het certificaatarchief, zoals de private key.
• UrlPatterns — de lijst met toegestane URL-domeinen of subdomeinen die het Cliëntcertificaat zullen gebruiken. Deze lijst kan bestaan uit meerdere URL-patronen die een enkel domein, subdomein of een wildcard voor een domein en al zijn subdomeinen kunnen zijn. Raadpleeg voor meer informatie de URL-patroonnotatie voor Enterprise-beleid .

5. Start de Uptrends-controlestationsoftware opnieuw op door het script update-images.ps1 uit te voeren vanuit de installatie-root directory.

6. Controleer of zowel de oude als de nieuwe certificaten worden herkend en correct zijn geïnstalleerd. Als er problemen optreden, voer dan een basisprobleemoplossing uit:

• Verifieer dat de JSON-bestandsnaam correct is.
• Zorg ervoor dat alle JSON-keywaardeparen voldoen aan de juiste JSON-syntaxis.
• Controleer op eventuele verkeerde configuraties of machtigingsproblemen.