Communitygithub.com

Identitätsföderation mit SAML und Azure AD einrichten

Konfigurieren Sie die SAML 2.0-Identitätsföderation zwischen einem lokalen Active Directory (über AD FS oder einen Drittanbieter-IdP) und Microsoft Entra ID. Behandelt Föderationsmodelle (AD FS, Passwort-Hash-Synchronisierung, Pass-Through-Authentifizierung, Drittanbieter-IdP) und den SAML-Authentifizierungsablauf. Verwenden Sie dies, wenn Sie eine lokale Authentifizierungsinstanz auf Cloud-Ressourcen ausweiten oder eine hybride SSO-Architektur für Entra ID entwerfen möchten.

Was ist Identitätsföderation mit SAML und Azure AD einrichten?

Diese Skill-Anleitung beschreibt die Einrichtung einer SAML 2.0-Identitätsföderation zwischen einem lokalen Active Directory und Microsoft Entra ID (ehemals Azure AD). Sie deckt verschiedene Föderationsmodelle ab, darunter AD FS (Active Directory Federation Services), Passwort-Hash-Synchronisierung (PHS), Pass-Through-Authentifizierung (PTA) sowie Drittanbieter-IdPs wie Okta oder Ping. Ziel ist es, eine nahtlose Single-Sign-On (SSO)-Umgebung zu schaffen, bei der die Authentifizierungsautorität lokal bleibt, während der Zugriff auf Cloud-Ressourcen ermöglicht wird. Die Anleitung führt Schritt für Schritt durch die Vorbereitung der AD FS-Infrastruktur, die Konfiguration des Azure AD-föderierten Domains, die Einrichtung von Claims-Regeln und die Anbindung von SaaS-Anwendungen. Wichtige Konzepte wie SAML-Authentifizierungsabläufe, Vertrauenskomponenten (Signaturzertifikat, Metadaten), Zertifikatslebenszyklus-Management und eine Validierungs-Checkliste werden ausführlich erläutert. Die Plattformen umfassen Windows Server (AD FS 2019+), Microsoft Entra ID und PowerShell- sowie Microsoft Graph-Befehle zur Automatisierung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/main/skills/building-identity-federation-with-saml-azure-ad

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Aufbau einer Identitätsföderation mit SAML und Azure AD

Überblick

Identitätsföderation ermöglicht es Benutzern, die von einem Identitätsanbieter authentifiziert wurden, auf Ressourcen eines anderen Anbieters zuzugreifen, ohne separate Anmeldeinformationen verwalten zu müssen. Diese Anleitung beschreibt die Einrichtung einer SAML 2.0-Föderation zwischen dem lokalen Active Directory einer Organisation (über AD FS oder einen Drittanbieter-IdP) und Microsoft Entra ID (ehemals Azure AD) sowie die Konfiguration von föderiertem SSO für SaaS-Anwendungen von Drittanbietern. Die Föderation vermeidet Bedenken hinsichtlich der Passwortsynchronisation und behält die Authentifizierungsautorität vor Ort, während sie SSO auf Cloud-Ressourcen ausweitet.

Wann verwenden

  • Beim Bereitstellen oder Konfigurieren von Identitätsföderation mit SAML und Azure AD in Ihrer Umgebung
  • Bei der Einrichtung von Sicherheitskontrollen gemäß Compliance-Anforderungen
  • Beim Aufbau oder der Verbesserung der Sicherheitsarchitektur für diesen Bereich
  • Bei der Durchführung von Sicherheitsbewertungen, die diese Implementierung erfordern

Voraussetzungen

  • Lokale Active Directory-Domäne
  • AD FS 2019+ oder SAML-IdP eines Drittanbieters (Okta, Ping, usw.)
  • Microsoft Entra ID-Mandant (P1- oder P2-Lizenz empfohlen)
  • Azure AD Connect (bei Verwendung einer hybriden Identität mit Passwort-Hash-Synchronisierung als Fallback)
  • Öffentliches TLS-Zertifikat für den Föderationsendpunkt
  • DNS-Einträge für den Föderationsdienstnamen

Kernkonzepte

Föderationsmodelle

ModellAuthentifizierungsautoritätAnwendungsfall
Föderiert (AD FS)Lokales AD FSRegulatorische Anforderung, Authentifizierung vor Ort zu behalten
Verwaltet (PHS)Azure AD mit Passwort-Hash-SynchronisierungEinfachste Cloud-Authentifizierung, AD FS nicht erforderlich
Verwaltet (PTA)Lokal über Pass-Through-AgentCloud-Authentifizierung, die gegen lokales AD validiert wird
Drittanbieter-FöderationExterner IdP (Okta, Ping)Multi-IdP-Umgebung

SAML-Föderationsarchitektur

Benutzer → Cloud-App (SP)
   │
   └── Weiterleitung zu Azure AD
          │
          ├── Azure AD prüft die föderierte Domäne
          │
          └── Weiterleitung zum lokalen AD FS
                 │
                 ├── AD FS authentifiziert gegen Active Directory
                 │
                 ├── AD FS stellt SAML-Token aus
                 │
                 └── Token wird zurück an Azure AD gesendet
                        │
                        ├── Azure AD validiert das Föderationsvertrauen
                        │
                        ├── Azure AD stellt eigenes Token aus
                        │
                        └── Benutzer erhält Zugriffstoken für die Cloud-App

Komponenten des Föderationsvertrauens

KomponenteBeschreibung
Token-SignaturzertifikatX.509-Zertifikat, das vom IdP zum Signieren von SAML-Assertionen verwendet wird
FöderationsmetadatenXML-Dokument, das IdP-Endpunkte und -Fähigkeiten beschreibt
Vertrauen der vertrauenden SeiteKonfiguration in AD FS für jeden SP (Azure AD)
AnspruchsregelnWandelt AD-Attribute in SAML-Ansprüche um
Aussteller-URIEindeutige Kennung für den IdP (Entitäts-ID)

Arbeitsablauf

Schritt 1: AD FS-Infrastruktur vorbereiten

# AD FS-Rolle installieren
Install-WindowsFeature ADFS-Federation -IncludeManagementTools

# AD FS-Farm konfigurieren
Install-AdfsFarm `
    -CertificateThumbprint $certThumbprint `
    -FederationServiceDisplayName "Corp Federation Service" `
    -FederationServiceName "fs.corp.example.com" `
    -ServiceAccountCredential $gmsaCredential

# Überprüfen, ob AD FS betriebsbereit ist
Get-AdfsProperties | Select-Object HostName, Identifier, FederationPassiveAddress

Schritt 2: Azure AD-föderierte Domäne konfigurieren

# Microsoft Graph PowerShell-Modul installieren
Install-Module Microsoft.Graph -Scope CurrentUser

# Mit Microsoft Graph verbinden
Connect-MgGraph -Scopes "Domain.ReadWrite.All"

# Verwaltete Domäne in föderierte Domäne umwandeln
# Verwendung der AD FS-Föderationsmetadaten-URL
$domainId = "corp.example.com"
$federationConfig = @{
    issuerUri = "http://fs.corp.example.com/adfs/services/trust"
    metadataExchangeUri = "https://fs.corp.example.com/adfs/services/trust/mex"
    passiveSignInUri = "https://fs.corp.example.com/adfs/ls/"
    signOutUri = "https://fs.corp.example.com/adfs/ls/?wa=wsignout1.0"
    signingCertificate = $base64Cert
    preferredAuthenticationProtocol = "saml"
}

# Föderationseinstellungen auf Domäne anwenden
New-MgDomainFederationConfiguration -DomainId $domainId -BodyParameter $federationConfig

Schritt 3: AD FS-Anspruchsregeln konfigurieren

# Vertrauen der vertrauenden Seite für Azure AD hinzufügen
Add-AdfsRelyingPartyTrust `
    -Name "Microsoft Office 365 Identity Platform" `
    -MetadataUrl "https://nexus.microsoftonline-p.com/federationmetadata/2007-06/federationmetadata.xml"

# Anspruchsregeln konfigurieren
$rules = @"
@RuleTemplate = "LdapClaims"
@RuleName = "Extract AD Attributes"
c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname",
   Issuer == "AD AUTHORITY"]
=> issue(store = "Active Directory",
   types = ("http://schemas.xmlsoap.org/claims/UPN",
            "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress",
            "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",
            "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname"),
   query = ";userPrincipalName,mail,givenName,sn;{0}",
   param = c.Value);

@RuleTemplate = "PassThroughClaims"
@RuleName = "Pass Through UPN as NameID"
c:[Type == "http://schemas.xmlsoap.org/claims/UPN"]
=> issue(Type = "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
   Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer,
   Value = c.Value,
   ValueType = c.ValueType,
   Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format"]
       = "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent");
"@

Set-AdfsRelyingPartyTrust `
    -TargetName "Microsoft Office 365 Identity Platform" `
    -IssuanceTransformRules $rules

Schritt 4: Drittanbieter-SaaS-Föderation konfigurieren

Führen Sie für jede SaaS-Anwendung, die SAML SSO über Azure AD unterstützt, Folgendes aus:

  1. Navigieren Sie zum Microsoft Entra Admin Center > Unternehmensanwendungen
  2. Fügen Sie die Anwendung aus dem Katalog hinzu (oder erstellen Sie eine benutzerdefinierte SAML-Anwendung)
  3. Konfigurieren Sie Einmaliges Anmelden > SAML:
    • Bezeichner (Entitäts-ID): Entitäts-ID der Anwendung
    • Antwort-URL (ACS): Assertion Consumer Service-URL der Anwendung
    • Anmelde-URL: Anmelde-URL der Anwendung
  4. Ordnen Sie Benutzerattribute/-ansprüche zu:
    • NameID: user.userprincipalname (E-Mail-Format)
    • Zusätzliche Ansprüche gemäß den Anforderungen der Anwendung
  5. Laden Sie die Föderationsmetadaten-XML oder das Zertifikat herunter
  6. Konfigurieren Sie die SaaS-App mit den Föderationsdetails von Azure AD

Schritt 5: Zertifikatslebenszyklus-Management

AD FS-Token-Signaturzertifikate laufen ab und müssen erneuert werden:

# Aktuelles Zertifikat-Ablaufdatum prüfen
Get-AdfsCertificate -CertificateType Token-Signing | Select-Object Thumbprint, NotAfter

# AD FS unterstützt automatischen Rollover (standardmäßig aktiviert)
Get-AdfsProperties | Select-Object AutoCertificateRollover

# Falls manuelle Rotation erforderlich ist:
# 1. Neues Zertifikat als sekundäres hinzufügen
Set-AdfsCertificate -CertificateType Token-Signing -Thumbprint $newThumbprint -IsPrimary $false
# 2. Azure AD mit dem neuen Zertifikat aktualisieren
# 3. Zum primären Zertifikat hochstufen
Set-AdfsCertificate -CertificateType Token-Signing -Thumbprint $newThumbprint -IsPrimary $true
# 4. Altes Zertifikat entfernen
Remove-AdfsCertificate -CertificateType Token-Signing -Thumbprint $oldThumbprint

Validierungs-Checkliste

  • AD FS-Farm betriebsbereit mit gültigen TLS- und Token-Signaturzertifikaten
  • Azure AD-Domäne als föderiert mit korrekten Metadaten konfiguriert
  • Anspruchsregeln wandeln AD-Attribute korrekt in SAML-Assertionen um
  • Testbenutzer kann sich über den gesamten Föderationsablauf authentifizieren
  • MFA auf AD FS- oder Azure AD-Bedingungszugriffsebene erzwungen
  • Automatischer Zertifikats-Rollover aktiviert oder manuelle Rotation geplant
  • Föderationsmetadaten-Endpunkt öffentlich zugänglich
  • Smart Lockout konfiguriert, um Brute-Force-Angriffe zu verhindern
  • Externetsperrrichtlinien auf AD FS konfiguriert
  • Überwachung für AD FS-Integrität und Zertifikatsablauf eingerichtet
  • Notfallwiederherstellung: Verwalteter Authentifizierungsfallback dokumentiert

Referenzen

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

abusing-dpapi-for-credential-access

Extract and decrypt Windows DPAPI-protected secrets (Credential Manager, browser logins/cookies, Wi-Fi credentials, KeePass keys) online or offline using SharpDPAPI, SharpChrome, Mimikatz, or Impacket

abusing-shadow-credentials-for-privesc

Take over Active Directory accounts by writing attacker-controlled public keys to msDS-KeyCredentialLink (Shadow Credentials) with pyWhisker, Whisker, or Certipy, then authenticate via PKINIT to recover the target

achieving-cmmc-level-2-compliance

>-

acquiring-disk-image-with-dd-and-dcfldd

Create forensically sound bit-for-bit disk images with dd or dcfldd on a Linux forensic workstation, preserving evidence integrity through hash verification (MD5/SHA) during acquisition. Use when imaging a suspect drive, USB device, or memory card for investigation, preserving volatile disk evidence during incident response, or producing a verified copy for legal or law-enforcement proceedings before any destructive analysis.

analyzing-active-directory-acl-abuse

Detect dangerous ACL misconfigurations in Active Directory using ldap3

analyzing-android-malware-with-apktool

Perform static analysis of Android APK malware using apktool for resource decompilation, jadx for Java source recovery, and androguard for manifest inspection, dangerous permission-combination detection, and identification of obfuscated code, dynamic code loading, and reflection-based API calls. Use to statically triage a suspicious APK without executing it or to build mobile malware detection rules.

analyzing-api-gateway-access-logs

Parses API Gateway access logs (AWS API Gateway, Kong, Nginx) to detect

analyzing-apt-group-with-mitre-navigator

Query ATT&CK data with attackcti, mitreattack-python, and stix2, then build MITRE ATT&CK Navigator layers and multi-layer heatmap overlays mapping one or more APT groups

analyzing-azure-activity-logs-for-threats

Queries Azure Monitor activity logs and sign-in logs via azure-monitor-query

analyzing-bootkit-and-rootkit-samples

Analyzes bootkit and advanced rootkit malware infecting the Master

analyzing-browser-forensics-with-hindsight

Parse Chromium-based browser databases with Hindsight to extract and correlate browsing history, downloads, cookies, cached content, autofill data, saved passwords, and extensions from Chrome, Edge, Brave, Opera, and Vivaldi into a unified timeline (XLSX, JSON, or SQLite output). Use during incident response, insider-threat investigations, or criminal cases when you need to reconstruct a user

analyzing-campaign-attribution-evidence

Systematically evaluate cyber-campaign evidence to attribute an operation to a threat actor, using the Diamond Model and Analysis of Competing Hypotheses (ACH) to weigh infrastructure overlaps, TTP consistency, malware code similarity, and timing/language artifacts into confidence-weighted attribution assessments. Use when an incident investigation needs a defensible attribution confidence level.

analyzing-certificate-transparency-for-phishing

Monitor Certificate Transparency logs using crt.sh and Certstream to

analyzing-cloud-storage-access-patterns

Detect abnormal access in AWS S3, GCS, and Azure Blob Storage by analyzing CloudTrail Data Events, GCS audit logs, and Azure Storage Analytics for after-hours bulk downloads, new-IP access, and API-call spikes (e.g. GetObject) via statistical baselines and time-series anomaly detection. Use when investigating suspected cloud data exfiltration or building related detection rules.

analyzing-cobalt-strike-beacon-configuration

Extract and analyze Cobalt Strike beacon configuration from PE files

analyzing-cobaltstrike-malleable-c2-profiles

Parse and analyze Cobalt Strike Malleable C2 profiles with dissect.cobaltstrike (profiles and beacon-payload configs) and pyMalleableC2 (AST parsing) to extract HTTP/DNS transforms, URIs, headers, sleep/jitter, and injection behavior, then generate network detection signatures. Use when reverse-engineering a captured malleable profile or building detections against Cobalt Strike Beacon traffic.

analyzing-command-and-control-communication

Analyzes malware C2 communication over HTTP, HTTPS, DNS, and custom

analyzing-cyber-kill-chain

Analyzes intrusion activity against the Lockheed Martin Cyber Kill Chain

analyzing-disk-image-with-autopsy

Perform comprehensive forensic analysis of raw (dd), E01, or AFF disk images with Autopsy and The Sleuth Kit, recovering deleted files, examining metadata and embedded artifacts, keyword searching, and building investigation timelines with visual reports. Use for structured analysis of a forensic disk image or when stakeholders need visual reports from evidence.

analyzing-dns-logs-for-exfiltration

Analyzes DNS query logs to detect data exfiltration via DNS tunneling,

Verwandte Skills