Aruba/HPE ClearPass
Kopiera länk till sidan “Aruba/HPE ClearPass”Förnyar HTTPS-, RADIUS- och RadSec-certifikat på en vald ClearPass-nod.
Så går det till
- Appliancen ansluter till Aruba/HPE ClearPass genom ClearPass Policy Manager REST API på port 443.
- Välj en klusternod och rollerna HTTPS, RADIUS eller RadSec. Certifikat, nyckel och mellankedja paketeras som krypterad PKCS#12 i minnet.
- Noden hämtar certifikatet och nyckeln som PKCS#12 från en tillfällig HTTP-lyssnare på appliancen eller servern med serviceagenten. RADIUS och RadSec byts före HTTPS; RSA och EC har var sin HTTPS-roll.
- Rollerna läses tillbaka och HTTPS kontrolleras med TLS. RADIUS bekräftas genom API:et utan EAP-inloggning; RadSec-proben är kompletterande information.
Tekniska detaljer
- Anslutning
- Integrationen körs på appliancen, som ansluter över HTTPS till ClearPass Policy Manager REST API, port 443. Ingen serviceagent installeras.
- Tjänstens portar
- 443
- Det här behöver ni
- Guest > Administration > API Services > API Clients: skapa en klient med grant type client_credentials och en operatörsprofil som får ändra plattformscertifikat (Super Administrator). Ange dess klient-ID och hemlighet här samt adressen till ClearPass-noden. ClearPass hämtar certifikatet från appliancen eller servern med serviceagenten via HTTP; maskinen måste kunna nås från noden (använd en serviceagent på en server i ClearPass-nätverket eller CLEARPASS_FETCH_ADDRESS).
- Plattform
- ClearPass Policy Manager REST API 6.14
- Åtgärder
- Discovery, Installation, Kontroll, Rollback
- Integrationer
-
aruba-clearpass-api1.0.0 - Observera
-
- Automatisk återställning kräver tidigare certifikat och matchande nyckel som indata. Ett tidigare par måste passa alla valda roller. Rollback använder deploys tillstånd och materialet som ska återställas; senare rolländringar bevaras. Certifikatkedjan består av de mellanliggande certifikat som kopplar serverns certifikat till ett rotcertifikat som webbläsaren litar på. ACME är det protokoll en CA använder för att utfärda certifikat automatiskt.
- CLEARPASS_FETCH_ADDRESS väljer en adress och eventuell port som noden kan nå. Integrationen sparar inga backupfiler. CEM-inställningar och enskilda RADIUS-tjänstcertifikat ändras inte.
Krav på certifikatet
ClearPass har separata HTTPS(RSA)- och HTTPS(ECC)-roller samt ett RADIUS/EAP-servercertifikat per nod. Integrationens nyckelval är RSA 2048, 3072 eller 4096 bitar och ECDSA P-256 eller P-384. API:ets CSR-meny omfattar även EC 521 bitar; 4096 och 521 är de största dokumenterade CSR-valen, inte dokumenterade maximistorlekar för externt importerade nycklar. ClearPass 6.11:s utvärderade TLS-konfiguration beskriver RSA 2048/3072/4096 och EC P-256/P-384. De offentliga importkällorna anger ingen generell minimi- eller maximistorlek för varje roll.
Common Name (CN) krävs när en CSR skapas i ClearPass. Källorna fastställer inte om CN krävs vid import av ett externt utfärdat servercertifikat. ACME är protokollet som en CA använder för att utfärda certifikat automatiskt. Kompatibilitet med CN-lösa ACME-profiler som tlsserver och minimal är därför inte dokumenterad. Använd SAN-namn som passar gästportalens värdnamn och klienternas validering av EAP-servern.
Använd ett servercertifikat för serverautentisering (serverAuth EKU). De kontrollerade importkällorna anger inget obligatoriskt clientAuth EKU eller keyEncipherment KU för HTTPS- eller RADIUS/EAP-servercertifikatet. CEM-guidens clientAuth-krav gäller certifikatet som autentiserar EST-klienten mot utfärdaren och ska inte överföras till servercertifikatet. EAP-klienternas egna krav gäller också; avsaknaden av ett publicerat importkrav är ingen garanti för alla klienter eller minimal-profiler.
Aruba avråder från wildcard i CN och EV-certifikat för RADIUS/EAP eftersom vissa klienter inte kan autentisera med dem. Det är en rekommendation, inte ett dokumenterat importförbud. CEM kan skapa DNS- och IP-SAN; de kontrollerade källorna anger inget maximalt antal SAN eller någon generell regel för IP-SAN vid extern import. HTTPS-namn och EAP-servernamn ska passa den valda tjänsten och klienternas konfiguration.
Importdialogen i ClearPass 6.12 accepterar ett certifikat med sparad nyckel, en PKCS#12-fil (.pfx/.p12) eller separata certifikat- och nyckelfiler. P7b Base64-kedjor stöds inte för HTTPS eller RADIUS/EAP. Roll-API:et i de kontrollerade 6.11- och 6.14.1-definitionerna hämtar certifikat eller PKCS#12 från en URL; nya externa nycklar levereras i PKCS#12 med lösenord. Dialogen anger inga PEM/DER-gränser och JKS-import är inte dokumenterad.
De kontrollerade källorna publicerar ingen versionsindelad importregel för PFX-kryptering med AES jämfört med 3DES/RC2. Ett exempel dokumenterar inte ett förbud mot AES. API:et skickar PFX-lösenordet i begärans body. 6.12-guiden anger klusterlösenordet vid PKCS#12-import i ett kluster; källorna fastställer inte att ett godtyckligt lösenord fungerar på alla klusterversioner. Staging-URL:en får inte innehålla inloggning, token eller lösenord.
En certifikatkedja är de mellanliggande certifikat som kopplar serverns certifikat till en rot som webbläsaren litar på. Leverera servercertifikatet med matchande privat nyckel och nödvändiga intermediärer. Importkällorna anger ingen bestämd kedjeordning eller obligatorisk inkludering av roten. Integrationen kan placera servercertifikatet först och sedan intermediärer mot utfärdaren; det är inget dokumenterat ClearPass-krav. En servercertifikatexport i PKCS#12 innehåller certifikatet, intermediärer och den privata nyckeln. API:ets certifikatavläsning innehåller ingen dokumenterad privat nyckel för rollback.
Roll-API:et väljer destination via nod-UUID och rollnamn. De kontrollerade källorna anger inga krav på PFX-friendly name eller alias, varken tecken eller maximal längd. Ett JKS-alias ska inte läggas till som ett ClearPass-krav.
Använd ett certifikat som är giltigt vid installationen. De kontrollerade källorna anger ingen ClearPass-gräns för minsta eller längsta giltighetstid vid extern import. Offentliga CA:ers regler och klienternas validering gäller separat och ska inte beskrivas som en importgräns i ClearPass.