# iOS-zertifikatbasierte Konfiguration

<Aside type="caution" title="Wichtig">
[Live-Aktivitäten](/de/developer/pushwoosh-sdk/ios-sdk/ios-live-activities/) in Pushwoosh erfordern eine [tokenbasierte Konfiguration](/de/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/). Wenn Sie Live-Aktivitäten verwenden möchten, stellen Sie sicher, dass Ihre iOS-Konfiguration diese Methode verwendet, da die zertifikatbasierte Konfiguration nicht unterstützt wird.
</Aside> 

Folgen Sie dieser Anleitung, um die iOS-Plattform manuell zu konfigurieren.

<Aside type="note">
Stellen Sie sicher, dass Sie ein Provisioning-Profil für Ihre App erstellt haben, um sie im App Store einzureichen. Lesen Sie mehr in der [Apple-Entwicklerdokumentation](https://developer.apple.com/help/account/provisioning-profiles/create-an-app-store-provisioning-profile).
</Aside>

## Erstellen einer Zertifikatsanforderungsdatei

1. Starten Sie die **Schlüsselbundverwaltung**, gehen Sie zum **Zertifikatsassistenten** und klicken Sie auf **Ein Zertifikat von einer Zertifizierungsstelle anfordern...**:

<img src="/ios-configuration-ios-platform-configuration-1.webp"
     alt="Schlüsselbundverwaltung unter macOS mit dem Menü des Zertifikatsassistenten zur Anforderung einer CSR für ein APNs-Zertifikat"/>

2. Geben Sie die erforderlichen Informationen ein und wählen Sie **Auf Festplatte sichern**. Das Feld für die CA-E-Mail-Adresse sollten Sie leer lassen. Klicken Sie auf **Fortfahren** und **sichern** Sie die Zertifikatsanforderung unter dem vorgeschlagenen Namen.

<img src="/ios-configuration-ios-platform-configuration-2.webp"
     alt="CSR in der Schlüsselbundverwaltung erstellen"/>

## Erstellen eines APNs-Zertifikats im Apple Developer Portal

1. Melden Sie sich im [Apple Developer Portal](https://developer.apple.com/account/) an und öffnen Sie **Certificates, Identifiers & Profiles** im Tab **Account**. Klicken Sie auf **Add**:

<img src="/ios-configuration-ios-platform-configuration-3.webp"
     alt="Apple Developer Portal – Dashboard für Certificates, Identifiers & Profiles mit der Schaltfläche zum Hinzufügen eines Zertifikats"/>

2. Wählen Sie den benötigten Zertifikatstyp aus und klicken Sie unten auf der Seite auf **Continue**.

<Aside type="note">
Sie können den Zertifikatstyp **Sandbox & Production** auswählen, der im Screenshot unten gezeigt wird, und dann das entsprechende **Gateway** bei der Konfiguration der iOS-Plattform im Pushwoosh Control Panel wählen.
Sie können bei Bedarf auch Sandbox- und Produktionszertifikate separat erstellen.
</Aside>

<img src="/ios-configuration-ios-platform-configuration-4.webp"
     alt="Auswahl des APNs SSL (Sandbox & Production) Zertifikatstyps im Apple Developer Portal"/>

3. Wählen Sie auf der nächsten Seite die **App ID** Ihres Projekts aus und klicken Sie dann auf **Continue**.

<img src="/ios-configuration-ios-platform-configuration-5.webp"
     alt="Auswahl der App ID für die Ausstellung des APNs-Zertifikats im Apple Developer Portal"/>

<Aside>
Sie können **Informationen zum Erstellen einer Zertifikatsignierungsanforderung (CSR)** überspringen, da Sie bereits eine erstellt haben.
</Aside>

4. Wählen Sie die zuvor erstellte **Zertifikatsignierungsanforderung** aus.

<img src="/ios-configuration-ios-platform-configuration-6.webp"
     alt="Hochladen der CSR-Datei"/>

5. Laden Sie das Zertifikat herunter und fügen Sie es zur **Schlüsselbundverwaltung** hinzu. Sobald Sie auf das Zertifikat klicken, wird die **Schlüsselbundverwaltung** gestartet.

<img src="/ios-configuration-ios-platform-configuration-7.webp"
     alt="Herunterladen des Zertifikats aus dem Apple Developer Portal"/>

## Exportieren des privaten Schlüssels (.p12)

Klicken Sie in der **Schlüsselbundverwaltung** mit der rechten Maustaste auf das gerade hinzugefügte Zertifikat und wählen Sie Exportieren.

<img src="/ios-configuration-ios-platform-configuration-8.webp"
     alt="Exportieren des privaten Schlüssels als .p12 aus der Schlüsselbundverwaltung"/>

Speichern Sie die Datei **Persönlicher Informationsaustausch (.p12)**. Sie werden aufgefordert, ein Passwort festzulegen.

<Aside type="caution" title="Wichtig">
Merken Sie sich das Passwort für den privaten Schlüssel, Sie werden es später benötigen.
</Aside>

Nachdem Sie Ihr Passwort eingegeben haben, klicken Sie auf **Erlauben**, um den Export des privaten Schlüssels abzuschließen.

## Konfigurieren der iOS-Plattform in Pushwoosh

Gehen Sie in Ihrem Pushwoosh-Projekt zum Abschnitt **Plattformen konfigurieren** und klicken Sie in der iOS-Zeile auf **Konfigurieren**:

<img src="/ios-configuration-ios-platform-configuration-9.webp" alt="Pushwoosh Control Panel mit der iOS-Zeile und der Schaltfläche Konfigurieren"/>

Wählen Sie im geöffneten Formular die **zertifikatbasierte manuelle Konfiguration** und klicken Sie auf **Weiter**:

<img src="/ios-configuration-ios-platform-configuration-10.webp" alt="Pushwoosh-Formular mit ausgewählter zertifikatbasierter manueller Konfiguration"/>

Führen Sie im geöffneten Fenster die folgenden Schritte aus:

* Laden Sie die Zertifikatsdatei (.p12) hoch
* Geben Sie das **Passwort für den privaten Schlüssel** ein
* Wählen Sie das **Gateway**

<img src="/ios-configuration-ios-platform-configuration-11.webp" alt="Felder zum Hochladen der .p12-Datei, zur Eingabe des Passworts und zur Auswahl des Gateways in Pushwoosh"/>

Klicken Sie auf **Konfigurieren**, um die Einrichtung abzuschließen.