Nutzerkonten hinzufügen und verwalten

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

Bevor Nutzer mit Ihrem Entwicklerdienst-Portal arbeiten können, müssen sie dem System hinzugefügt werden. Standardmäßig kann sich jeder Nutzer im Entwicklerportal registrieren, indem er im Portalmenü den Link „Registrieren“ auswählt. Das Konto des Nutzers wird dann automatisch authentifiziert und ihm wird die Rolle „Authentifizierter Nutzer“ zugewiesen.

Sie können Ihr Entwicklerportal so anpassen, dass nur Nutzer mit Administratorberechtigungen Nutzerkonten hinzufügen können. In diesem Fall müssen Nutzerkonten manuell von einem Administrator hinzugefügt werden. Unter Umständen muss ein Administrator auch Nutzerkonten manuell für interne Entwickler hinzufügen oder Entwickler im Namen eines Kunden hinzufügen.

Nachdem ein Nutzerkonto hinzugefügt wurde, kann ein Administrator dem Nutzerkonto eine Rolle zuweisen, wodurch die Berechtigungen für diese Rolle mit dem Konto verknüpft werden. Außerdem kann ein Administrator ein vorhandenes Nutzerkonto verwalten, z. B. das Nutzerprofil für das Konto bearbeiten, das Konto löschen, das Konto sperren oder entsperren oder dem Konto eine neue Rolle zuweisen. Administratoren können auch festlegen, was mit dem Nutzerkonto und den zugehörigen Inhalten (z. B. Blogeinträgen und Forumsbeiträgen) passiert, wenn das Konto gekündigt wird.

Das Entwicklerportal kann automatisch E-Mails an Nutzer senden, wenn Ereignisse auftreten. So kann das Portal beispielsweise eine E-Mail senden, wenn ein Nutzer hinzugefügt, ein Konto blockiert oder ein Konto gekündigt wird. Im Rahmen der Nutzerverwaltung können Sie den Inhalt und das Format dieser E-Mails festlegen. Weitere Informationen finden Sie unter E-Mails konfigurieren.

Festlegen, wer Konten registrieren darf

Standardmäßig kann jeder Nutzer über das Entwicklerportal ein Konto erstellen, indem er auf den Link „Registrieren“ klickt.

So legen Sie fest, wer Konten registrieren darf:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Personen > Kontoeinstellungen aus. Daraufhin wird die Seite „Kontoeinstellungen“ geöffnet.
3. Klicken Sie im Abschnitt „Registrierung und Kündigung“ unter „Wer kann Konten registrieren?“ auf die entsprechende Registrierungsoption. Folgende Optionen sind verfügbar:
   • Nur Administratoren:Nur Administratoren können Nutzerkonten registrieren.
   • Besucher: Jeder kann sich registrieren. Das ist die Standardeinstellung.
   • Besucher, aber Administratorzustimmung erforderlich:Jeder kann sich registrieren, aber ein Administrator muss das Konto autorisieren.
4. Setzen oder entfernen Sie ein Häkchen bei E-Mail-Bestätigung beim Erstellen eines Kontos durch einen Besucher erforderlich machen. Wenn diese Option nicht aktiviert ist, wird der Entwickler nach der Registrierung sofort im Portal angemeldet. Wenn diese Option aktiviert ist, erhält der Nutzer eine E-Mail, über die er seine E-Mail-Adresse bestätigen kann, bevor er sich anmelden kann.
5. Klicken Sie auf Save configuration (Konfiguration speichern).

Nutzerkonto hinzufügen

Je nach Portalkonfiguration müssen Administratoren Nutzer manuell hinzufügen oder Nutzer können sich selbst hinzufügen, indem sie im Entwicklerportal den Link „Registrieren“ auswählen.

Nutzerkonto manuell hinzufügen

So fügen Sie ein Nutzerkonto manuell hinzu:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Personen > Nutzer hinzufügen aus.
3. Geben Sie in den Feldern „Vorname“, „Nachname“, „Nutzername“, „E-Mail-Adresse“ und „Passwort“ Inhalte für den Nutzer ein und bestätigen Sie die Nutzervereinbarung.
4. Legen Sie optional den Status und die Rollen für den Nutzer fest.
5. Wählen Sie Nutzer über neues Konto benachrichtigen aus, um eine automatische E-Mail an den Nutzer zu senden.
6. Klicken Sie auf Konto erstellen.

Nutzer über das Entwicklerportal registrieren

So registrieren Sie einen Nutzer über das Entwicklerportal:

1. Der Nutzer wählt auf der Startseite des Entwicklerportals Registrieren aus.
2. Die Registrierungsseite wird angezeigt.
3. Der Nutzer gibt die erforderlichen Informationen ein und wählt Neues Konto erstellen aus.
   Je nach den Einstellungen für die Registrierung neuer Konten erhält der Nutzer beim Erstellen des Kontos eine automatische Willkommens-E-Mail.

Automatische Benachrichtigung des Administrators bei der Registrierung eines neuen Nutzers

Wenn sich ein neuer Nutzer im Portal registriert, erhält er standardmäßig eine E-Mail. Weitere Informationen finden Sie unter E-Mails konfigurieren.

Portaladministratoren werden jedoch standardmäßig nicht benachrichtigt, wenn sich ein neuer Nutzer registriert. Wenn Sie das Portal beispielsweise so konfigurieren, dass neue Nutzer eine Administratorgenehmigung benötigen, um ihr Konto zu aktivieren, sollten Sie dafür sorgen, dass Administratoren benachrichtigt werden, wenn das neue Konto erstellt wird. Andernfalls bleibt das Nutzerkonto inaktiv.

So benachrichtigen Sie Administratoren, wenn ein neuer Nutzer ein Konto registriert:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Personen > Administratorbenachrichtigung aus.
3. Geben Sie unter Nutzerwarnungen an, wer die E-Mail erhält. Sie können sie an folgende Adresse weiterleiten:
   • An eine benutzerdefinierte E-Mail-Adresse senden
   • An eine bestimmte Rolle senden Wenn Sie diese Option auswählen, sollten Sie eine neue Rolle erstellen. Andernfalls erhalten alle Administratoren die E-Mail, wenn Sie eine Rolle wie „Administrator“ auswählen, auch wenn sie möglicherweise nicht für alle Administratoren gilt.
   • Beides
4. Bearbeiten Sie den Betreff und den Text der Nachricht.
5. Wählen Sie aus, wann die E-Mail gesendet werden soll:
   • E-Mail-Benachrichtigung bei der Nutzererstellung erhalten
   • E-Mails beim Erstellen und Aktualisieren von Nutzern erhalten
6. Klicken Sie auf Save configuration (Konfiguration speichern).

Nutzerkonto verwalten

Administratoren können Nutzerkonten verwalten, um Nutzerinformationen festzulegen, Passwörter zurückzusetzen, Konten zu aktivieren, Konten zu kündigen oder zu sperren und andere Aufgaben auszuführen.

So bearbeiten Sie das Nutzerprofil für ein Nutzerkonto:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Personen aus.
3. Mit dem Filterbereich oben auf der Seite können Sie die Anzeige der Nutzer nach einem bestimmten Nutzernamen, einer E-Mail-Adresse, einem Status oder einer Berechtigung filtern. Standardmäßig ist für diese Filter „beliebig“ ausgewählt. In diesem Fall werden alle Nutzer auf der Seite aufgeführt.
   

   

4. Klicken Sie in der Zeile „Nutzername“ für das Nutzerkonto auf Bearbeiten. Daraufhin wird eine bearbeitbare Ansicht des Nutzerprofils geöffnet.
5. Ändern Sie die Nutzerprofildaten nach Bedarf.
6. Klicken Sie auf Speichern.

CAPTCHA hinzufügen

Sie können der Anmeldeseite und anderen Seiten eine CAPTCHA-Aufgabe hinzufügen, indem Sie die Drupal-Module CAPTCHA und reCAPTCHA aktivieren. Das reCAPTCHA-Modul bietet Unterstützung für den kostenlosen Google reCAPTCHA-Dienst.

Drupal unterstützt auch andere CAPTCHA-Module, z. B. Bild-CAPTCHA, die Sie auch im Portal verwenden können.

So aktivieren Sie reCAPTCHA:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Menü Module aus.
3. Aktivieren Sie sowohl das CAPTCHA- als auch das reCAPTCHA-Modul.
4. Registrieren Sie sich unter https://www.google.com/recaptcha/intro/index.html für reCAPTCHA-Schlüssel von Google.
5. Wählen Sie im Drupal-Menü Konfiguration > Personen > CAPTCHA > reCAPTCHA aus.
6. Geben Sie den öffentlichen Schlüssel (Google-Websiteschlüssel) und den privaten Schlüssel (Google-Secret-Schlüssel) ein. Die restlichen Einstellungen können Sie bei den Standardwerten belassen.
7. Wählen Sie Konfiguration > Personen > CAPTCHA aus, um festzulegen, wo das reCAPTCHA-Formular angezeigt werden soll. Standardmäßig wird sie in den Anmelde- und Registrierungsformularen für Nutzer angezeigt.
8. Legen Sie auf dieser Seite für jedes Formular den Herausforderungstyp fest.
9. Speichern Sie die Änderungen.

Seite mit Nutzungsbedingungen hinzufügen

Sie können dem Entwicklerportal eine Seite mit Nutzungsbedingungen hinzufügen, die Nutzer bei der Anmeldung akzeptieren müssen, bevor sie auf das Portal zugreifen dürfen. Wenn Sie die Seite mit den Nutzungsbedingungen später ändern, müssen Nutzer die aktualisierten Nutzungsbedingungen bei der nächsten Anmeldung akzeptieren.

Für die Implementierung der Seite mit den Nutzungsbedingungen wird das Drupal-Modul „Recht“ verwendet. Dieses Modul bietet eine flexible Möglichkeit, eine Seite mit Nutzungsbedingungen zu erstellen, den Änderungsverlauf der Nutzungsbedingungen zu erfassen und Nutzer zu erfassen, die die Nutzungsbedingungen akzeptiert haben.

Nach dem Erstellen hat die Seite mit den Angebotsbedingungen die URL <siteURL>/legal.

So aktivieren Sie das Modul „Rechtliche Hinweise“:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Module aus. Die Liste aller installierten Drupal-Module wird angezeigt.
3. Scrollen Sie auf der Seite nach unten und klicken Sie das Kästchen neben Modul zu rechtlichen Hinweisen an.
4. Klicken Sie auf Save configuration (Konfiguration speichern).

So erstellen Sie eine Seite mit Nutzungsbedingungen:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Personen > Rechtliches aus.
   Dieser Menüpunkt wird nur angezeigt, wenn das Modul „Rechtliche Hinweise“ aktiviert ist. Im oberen Feld auf der Seite unter „Aktuelle Version/Revision“ werden die aktuellen Nutzungsbedingungen angezeigt. Wenn Sie keine Nutzungsbedingungen festgelegt haben, ist dieser Bereich leer. Sie erstellen eine neue Version im Bereich „Nutzungsbedingungen“ unter „Neue Version/Übersetzung erstellen“.
3. Geben Sie Ihre Nutzungsbedingungen im Bereich „Nutzungsbedingungen“ ein.
4. Wählen Sie aus, wie die Nutzungsbedingungen auf der Seite angezeigt werden sollen: Scrollfeld, Scrollfeld (CSS), HTML-Text oder Seitenlink.
5. Optional können Sie zusätzliche Kästchen und ein Textfeld hinzufügen, in dem Sie Ihre letzten Änderungen beschreiben.
6. Wählen Sie Vorschau aus, um eine Vorschau Ihrer Nutzungsbedingungen im Bereich „Nutzungsbedingungen“ unter „Neueste Version/Überarbeitung“ aufzurufen, oder Speichern, um sie zu speichern.

So verfolgen Sie Änderungen an den Nutzungsbedingungen und deren Akzeptanz:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Personen > Rechtliches aus.
3. Wählen Sie den Tab Verlauf der Nutzungsbedingungen aus, um den Überarbeitungsverlauf der Nutzungsbedingungen aufzurufen.
4. Wählen Sie den Tab Akzeptiert aus, um eine Liste der Nutzer aufzurufen, die die einzelnen Versionen der Nutzungsbedingungen akzeptiert haben.

Nutzer bei der Anmeldung weiterleiten

Wenn sich ein Nutzer im Portal anmeldet, wird er standardmäßig zu einer Seite weitergeleitet, auf der seine Informationen wie Vor- und Nachname angezeigt werden. Alternativ können Sie mit dem Modul Drupal Rules eine Regel hinzufügen, um Nutzer automatisch auf eine andere Seite weiterzuleiten. Sie können den Nutzer beispielsweise auf die Seite mit allen seinen Apps oder auf die Startseite des Portals weiterleiten.

Bevor Sie eine Weiterleitungsregel erstellen können, müssen alle erforderlichen Drupal-Module aktiviert sein.

Aktivieren Sie die erforderlichen Drupal-Module:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Module aus.
3. Aktivieren Sie die folgenden Module, falls noch nicht geschehen:
   • Aliasse für „me“ (werden oben in der Modulliste angezeigt, nicht wie alle anderen Module an ihrer alphabetischen Position)
   • LoginToboggan
   • Regeln
   • Benutzeroberfläche für Regeln
4. Klicken Sie auf Save configuration (Konfiguration speichern).
   Möglicherweise werden andere erforderliche Module automatisch aktiviert.

Anmeldeweiterleitungsregel erstellen:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Workflow > Regeln aus.
3. Wählen Sie auf der Seite „Regeln“ die Option + Neue Regel hinzufügen aus.
4. Geben Sie den Namen der Regel an: „Anmeldung – Weiterleitung“.
5. Geben Sie optional ein Tag als „login“ an.
6. Wählen Sie im Drop-down-Menü „Auf Ereignis reagieren“ die Option Nutzer > Nutzer hat sich angemeldet aus.
   
7. Wählen Sie Speichern aus.
   Die Seite „Reaktionsregel bearbeiten“ wird angezeigt. Sie haben das Ereignis bereits im vorherigen Schritt festgelegt. Daher sollte unter „Ereignis“ „Nutzer hat sich angemeldet“ angezeigt werden. Lassen Sie das Feld „Bedingungen“ für diese Regel leer.
8. Wählen Sie unter „Aktionen“ die Option + Aktion hinzufügen aus.
9. Wählen Sie im Drop-down-Menü System > Seitenweiterleitung aus.
   Das Layout der Seite „Neue Aktion hinzufügen“ ändert sich, damit Sie die Weiterleitungs-URL angeben können.
10. Geben Sie unter „Wert“ user/[account:uid]/apps an.
    [account:uid] ist ein Ersatzmuster, das der Portal-ID des Nutzers entspricht. Wenn Sie die vollständige Liste der Ersatzmuster sehen möchten, wählen Sie unter dem Eingabefeld „Wert“ die Option „Ersatzmuster“ aus.
11. Klicken Sie auf Speichern, um zur Seite „Bearbeiten der Reaktionsregel“ zurückzukehren. Die Seite sollte so aussehen:
    
12. Klicken Sie auf Änderungen speichern.
    Wenn Sie die Regel später bearbeiten möchten, wählen Sie auf der Seite „Konfiguration“ die Option „Regeln“ und dann in der Liste der Regeln die Option „Anmeldungsweiterleitung“ aus.

Wenn sich ein Nutzer jetzt anmeldet, wird er auf die Seite mit allen seinen Apps weitergeleitet. Wenn Sie Nutzer stattdessen zur Startseite des Portals weiterleiten möchten, bearbeiten Sie den Wert, den Sie oben in Schritt 11 festgelegt haben, um die URL der Startseite Ihres Portals anzugeben. Beispiel: http://dev-myCompany.devportal.apigee.io/.

Nutzerrollen und ‑berechtigungen festlegen

Eine Rolle definiert eine bestimmte Reihe von Berechtigungen, die es einem Nutzer ermöglichen, bestimmte Aktivitäten auszuführen. Sie gewähren einem Nutzer oder einer Gruppe von Nutzern Berechtigungen, indem Sie dem Nutzer eine Rolle mit den erforderlichen Berechtigungen zuweisen. Administratoren verwalten Rollen und legen Berechtigungen für Rollen im Entwicklerportal fest.

Standardmäßig werden in Drupal zwei Rollen erstellt:

• anonymous user: Die Rolle für alle Nutzer, die nicht angemeldet sind. Anonyme Nutzer können die meisten Aktionen nicht ausführen.
• authentifizierter Nutzer: Die Standardrolle, die allen Nutzern zugewiesen ist. Sie können einem Nutzer zusätzliche Rollen zuweisen, er hat jedoch immer diese Rolle.

Außerdem wurde in Apigee die Rolle Administrator hinzugefügt. Weisen Sie Nutzern die Administratorrolle zu, um ihnen Administratorrechte für das Portal zu gewähren.

Normalerweise fügen Sie Ihrem Portal Rollen hinzu, damit Sie Berechtigungen basierend auf verschiedenen Nutzertypen unterscheiden können. Ein Nutzer kann eine oder mehrere Rollen haben. Allen Nutzern wird die Rolle „Authentifizierter Nutzer“ zugewiesen. Wenn Sie einem Nutzer jedoch zusätzliche Rollen zuweisen möchten, müssen Sie Ihrem Portal Logik hinzufügen oder die Rollenzuweisung manuell vornehmen.

So rufen Sie alle Rollen und Berechtigungen auf:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Personen > Berechtigungen > Rollen aus.

So fügen Sie eine neue Rolle hinzu:

1. Wählen Sie Personen > Berechtigungen > Rollen aus.
2. Geben Sie auf der Seite „Personen“ im Textfeld über der Schaltfläche „Rolle hinzufügen“ einen neuen Rollennamen ein.
3. Klicken Sie auf Rolle hinzufügen.

So bearbeiten Sie eine Rolle:

1. Wählen Sie Personen > Berechtigungen > Rollen aus.
2. Klicken Sie auf der Seite „Personen“ in der Zeile der entsprechenden Rolle auf Rolle bearbeiten.
3. Ändern Sie den Rollennamen nach Bedarf.
4. Klicken Sie auf Speichern.

So löschen Sie eine Rolle:

1. Wählen Sie Personen > Berechtigungen > Rollen aus.
2. Klicken Sie auf der Seite „Personen“ in der Zeile der entsprechenden Rolle auf Rolle bearbeiten.
3. Klicken Sie auf Rolle löschen.

So fügen Sie einer Rolle einen Nutzer hinzu:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Personen aus.
3. Klicken Sie in der Zeile „Nutzername“ für das Nutzerkonto auf Bearbeiten. Daraufhin wird eine bearbeitbare Ansicht des Nutzerprofils geöffnet.
4. Wählen Sie alle Rollen für den Nutzer aus.
5. Klicken Sie auf Speichern.

So ändern Sie die Berechtigungen für eine Rolle:

1. Wählen Sie Personen > Berechtigungen > Rollen aus.
2. Klicken Sie auf der Seite „Personen“ auf den Tab Berechtigung.
   Eine Tabelle mit Rollen und Berechtigungen wird angezeigt. Mit Häkchen in der Tabelle wird angegeben, welchen Rollen welche Berechtigungen zugewiesen sind.
   

   

3. Klicken Sie das Kästchen an oder entfernen Sie das Häkchen, um der Rolle die entsprechende Berechtigung zu erteilen oder zu entziehen.
   Wenn Sie beispielsweise verhindern möchten, dass authentifizierte Nutzer Apps erstellen oder löschen können, scrollen Sie in der Berechtigungstabelle nach unten zum Abschnitt DevConnet-Entwickler-Apps und entfernen Sie die Häkchen aus den Kästchen DevConnet-Entwickler-Apps erstellen und DevConnet-Entwickler-Apps löschen unter authentifizierte Nutzer.
4. Klicken Sie auf Berechtigungen speichern.

Formularfelder für die Registrierung von Nutzern anpassen

Wenn sich der Nutzer im Portal für ein Konto registriert, wird die Standardregistrierungsseite mit Feldern für Vor- und Nachname, Nutzername, E-Mail-Adresse und Passwort angezeigt. Als API-Anbieter können Sie dieses Formular ändern, um Nutzer dazu aufzufordern, zusätzliche Informationen wie den Namen des Unternehmens, die Postanschrift oder andere Informationen anzugeben. Im Portal können Sie diesem Formular neue Felder hinzufügen. Diese Felder können Folgendes sein:

• Erforderlich oder optional
• Sie werden durch verschiedene HTML-Elemente wie Textfelder, Optionsfelder und Kästchen dargestellt.
• Kann so eingestellt werden, dass er überall im Formular angezeigt wird

Sie können beispielsweise ein Pflichtfeld für den Namen des Unternehmens oder ein optionales Feld für die Telefonnummer hinzufügen. Sie können auch mehrere Felder hinzufügen, sowohl optionale als auch erforderliche.

Das folgende Bild zeigt ein Pflichtfeld für den Unternehmensnamen, das dem Formular hinzugefügt wurde:

Als Portaladministrator können Sie die Informationen des Nutzers, einschließlich benutzerdefinierter Felder, aufrufen und bearbeiten. Gehen Sie dazu so vor:

1. Wählen Sie im Drupal-Verwaltungsmenü des Portals die Option Personen aus.
2. Wählen Sie in der Zeile mit dem Namen des Nutzers die Option Bearbeiten aus.

Das ist die Hauptmethode, mit der Sie als Administrator auf Nutzerinformationen zugreifen.

Wenn Sie dem Formular neue Felder hinzufügen, werden die Feldwerte standardmäßig nicht in Edge hochgeladen. Sie können das Portal jedoch so konfigurieren, dass diese Werte hochgeladen werden, wenn der Nutzer das Formular einreicht. Das bedeutet, dass Sie diese Felder in Edge aufrufen oder über die Edge Management API über ein Script auf diese Felder zugreifen können.

Die neuen Formularfelder in der Edge-Verwaltungsoberfläche finden Sie beispielsweise unter Veröffentlichen > Entwickler. Wählen Sie dann den Nutzernamen aus. Die neuen Feldwerte werden auf der Seite im Bereich „Benutzerdefinierte Attribute“ mit einem Namen angezeigt, der dem internen Namen des Felds entspricht:

So fügen Sie dem Registrierungsformular für Nutzer ein Feld hinzu:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Personen > Kontoeinstellungen aus.
3. Klicken Sie oben auf der Seite auf die Schaltfläche Felder verwalten.
4. Scrollen Sie auf der Seite nach unten zum Bereich „Neues Feld hinzufügen“:
   
5. Konfigurieren Sie das Feld. Verwenden Sie für das oben gezeigte Feld „Name des Unternehmens“ beispielsweise die folgenden Einstellungen:
   
6. Klicken Sie auf Speichern.
7. Da es sich um ein Textfeld handelt, werden Sie aufgefordert, die maximale Länge des Felds anzugeben.
8. Geben Sie die maximale Länge ein und wählen Sie Feldeinstellungen speichern aus.
9. Daraufhin wird eine neue Seite angezeigt, auf der Sie zusätzliche Informationen für das Feld angeben können, darunter:
   • Ein Kästchen, um das Feld als Pflichtfeld festzulegen.
   • Ein Kästchen, mit dem Sie angeben können, ob das Feld angezeigt werden soll.
   • Optionaler Hilfetext, der in einem Pop-up im Formular angezeigt wird.
   • Andere Einstellungen
10. Setzen Sie ein Häkchen in das Kästchen, um dieses Feld als Pflichtfeld festzulegen.
11. Wenn Sie auf dieser Seite Änderungen vornehmen, speichern Sie Ihre Einstellungen.
    Möglicherweise müssen Sie den Browsercache leeren, damit das neue Feld im Formular angezeigt wird.

So ordnen Sie die Attribute im Formular neu an:

Standardmäßig werden neue Pflichtfelder im Formular nach dem Feld „Nachname“ angezeigt. Optionale Felder werden unten im Formular nach den Passwortfeldern angezeigt.

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Personen > Kontoeinstellungen aus.
3. Klicken Sie oben auf der Seite auf die Schaltfläche Felder verwalten.
4. Klicken Sie unter der Spalte „Label“ auf das Pluszeichen + und ziehen Sie das Feld an die Stelle, an der es im Formular angezeigt werden soll.
5. Speichern Sie die Änderungen.

Werte von Formularfeldern als benutzerdefinierte Entwicklerattribute in Edge speichern

Sie können Werte von Formularfeldern in Edge in benutzerdefinierten Entwicklerattributen speichern. Sie können benutzerdefinierte Attribute für einen Entwickler aufrufen und verwalten, wie im Hilfeartikel App-Entwickler verwalten beschrieben.

Nachdem die benutzerdefinierten Entwicklerattribute gespeichert wurden, können Sie beispielsweise mit der Access Entity-Richtlinie ein dynamisches Verhalten basierend auf den Werten der benutzerdefinierten Attribute aktivieren.

So speichern Sie die Feldwerte als benutzerdefinierte Entwicklerattribute in Edge:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Dev-Portal > Entwicklerattribute aus.
   Eine Liste der verfügbaren Felder wird angezeigt.
3. Wählen Sie das Feld aus, das als Attribut in Edge gespeichert werden soll, z. B. „Name des Unternehmens“.
4. Setzen Sie ein Häkchen bei Dieses Feld als Attribut in Edge speichern.
5. Geben Sie den Namen des Edge-Attributs an. Das ist der Name, der in der Spalte „Name“ der Tabelle „Benutzerdefinierte Attribute“ für den Nutzer angezeigt wird.
6. Geben Sie das Verhalten für ein leeres Feld an.
7. Wählen Sie den String Wert in „wahr“|„falsch“ konvertieren aus, wenn Sie den Wert als Booleschen Wert einfügen und vor dem Senden an Edge in einen String vom Typ „wahr“ oder „falsch“ konvertieren möchten.
8. Klicken Sie auf Save configuration (Konfiguration speichern).
   Jetzt wird das benutzerdefinierte Attribut in Edge hochgeladen, wenn der Nutzer das Formular einreicht. Wenn Sie als Administrator den Wert eines benutzerdefinierten Felds ändern möchten, tun Sie dies über das Portal und nicht über Edge.

Standard-App erstellen, wenn ein Nutzer ein neues Konto registriert

Sie können eine Standard-App automatisch erstellen, wenn ein Nutzer ein neues Portalkonto registriert. Wenn sich der Nutzer zum ersten Mal anmeldet, wird die App auf der Seite „Meine Apps“ angezeigt. Je nach den Berechtigungen, die der Rolle des Nutzers zugewiesen sind, können Sie ihm erlauben, weitere Apps hinzuzufügen. Es kann sich aber auch um die einzige App handeln, die für den Nutzer verfügbar ist.

Sie haben die volle Kontrolle über die Eigenschaften der Standard-App, darunter:

• Die in der App enthaltenen API-Produkte
• App-Status: ausstehend oder genehmigt
• Callback-URL, falls erforderlich
• Benutzerdefinierte Parameter, die auf die App angewendet werden

Sie können das Erstellen einer Standard-App steuern, indem Sie mit dem Drupal-Regeln-Modul eine Regel erstellen. Mit einer Regel können Sie eine Aktion definieren, die als Reaktion auf ein Ereignis im Portal ausgeführt wird. In diesem Szenario ist das Ereignis die Registrierung eines Nutzers für ein Konto im Portal. Die Aktion besteht darin, eine Standard-App für den Nutzer zu erstellen.

Im Abschnitt Formularfelder zur Registrierung einer App anpassen wird beschrieben, wie Sie benutzerdefinierte Attribute hinzufügen, die zum Konfigurieren einer App verwendet werden. Diese Attribute können optional oder erforderlich sein, je nachdem, wie Sie sie definieren. Wenn Sie benutzerdefinierte App-Attribute erstellt haben, können Sie diese beim Definieren einer Standard-App festlegen.

Aktivieren Sie die Drupal-Regelnmodule:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Module aus.
3. Aktivieren Sie die folgenden Module, falls noch nicht geschehen:
   • Aliasse für „me“ (werden oben in der Modulliste angezeigt, nicht wie alle anderen Module an ihrer alphabetischen Position)
   • LoginToboggan
   • Regeln
   • Benutzeroberfläche für Regeln
4. Klicken Sie auf Save configuration (Konfiguration speichern).
   Möglicherweise werden andere erforderliche Module automatisch aktiviert.

So erstellen Sie eine Regel, um eine Standard-App hinzuzufügen:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Workflow > Regeln aus.
3. Klicken Sie auf die Schaltfläche + Neue Regel hinzufügen.
4. Geben Sie den Namen der Regel an.
5. Geben Sie optional „login“ im Feld Tags oder ein anderes Tag ein, mit dem Sie die Regel kategorisieren möchten.
6. Wählen Sie im Drop-down-Menü Auf Ereignis reagieren die Option Nutzer > Nach dem Speichern eines neuen Nutzerkontos aus.
7. Klicken Sie auf Speichern.
   Die Seite zum Bearbeiten der Regel wird angezeigt. Sie haben das Ereignis bereits im vorherigen Schritt festgelegt. Daher sollte unter „Ereignis“ „Nach dem Speichern eines neuen Nutzerkontos“ angezeigt werden.
8. Lassen Sie das Feld Bedingungen für diese Regel leer.
9. Wählen Sie unter Aktionen die Option + Aktion hinzufügen aus.
10. Wählen Sie im Drop-down-Menü Devconnect > Create a developer application (Devconnect > Entwickleranwendung erstellen) aus.
    Das Layout der Seite „Neue Aktion hinzufügen“ ändert sich, damit Sie die App konfigurieren können.
11. Geben Sie unter API-Name den Namen der Standard-App an. Verwenden Sie beispielsweise [account:field_last_name].
    Der Wert [account:field_last_name] ist ein Ersatzmuster, das dem Nachnamen des Nutzers entspricht. Wenn Sie die vollständige Liste der Ersatzmuster sehen möchten, wählen Sie unter dem Eingabefeld Wert die Option Ersatz aus.
12. Legen Sie Entwickler-UID auf [account:uid] fest. Dieser Wert ist erforderlich, um den Nutzer mit der App zu verknüpfen.
13. Legen Sie den Status der App auf ausstehend oder genehmigt fest. Legen Sie den Status auf ausstehend fest, wenn ein Administrator die App noch genehmigen muss, bevor der Nutzer sie verwenden kann, um auf Ihre APIs zuzugreifen.
14. Legen Sie bei Bedarf die Callback-URL für die App fest. Dieses Feld wird nur angezeigt, wenn Sie Apps so konfiguriert haben, dass eine Callback-URL erforderlich ist. Weitere Informationen zum Konfigurieren von Callback-URLs finden Sie unter Verarbeitung von Callback-URLs konfigurieren.
15. Legen Sie alle benutzerdefinierten App-Attribute fest, die Sie definiert haben, unabhängig davon, ob sie optional oder erforderlich sind. Weitere Informationen finden Sie unter Formularfelder für die Registrierung einer App anpassen.
16. Geben Sie die in der App enthaltenen API-Produkte an.
    Im Textfeld Wert muss jedes API-Produkt in einer separaten Zeile ohne Kommas oder andere Trennzeichen aufgeführt werden. Die Liste der verfügbaren API-Produkte wird über dem Textfeld Wert angezeigt.
17. Klicken Sie auf Speichern, um zur Seite „Bearbeitungsregel“ zurückzukehren.
18. Klicken Sie auf Änderungen speichern.
19. Wenn Sie die Regel später bearbeiten möchten, wählen Sie im Drupal-Verwaltungsmenü Konfiguration > Workflow > Regeln und dann die Regel aus der Liste aus.

Wenn sich ein neuer Nutzer zum ersten Mal im Portal anmeldet und im Menü den Link „Meine Apps“ auswählt, wird jetzt eine App mit dem Namen Nachname-Anwendung angezeigt. Dabei ist Nachname der Nachname, der bei der Registrierung des Kontos verwendet wurde.

Nutzer-Apps verwalten

Als Portaladministrator können Sie Nutzer-Apps direkt über das Portal mithilfe des Berichts zu Entwickler-Apps verwalten. In diesem Bericht kann ein Administrator Informationen zur App eines Nutzers aufrufen, die App ändern oder löschen. Ein Portaladministrator kann beispielsweise API-Produkte hinzufügen oder entfernen, die Rückruf-URL ändern oder andere Änderungen vornehmen.

So verwalten Sie eine Nutzer-App:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Berichte > Entwickler-Apps aus. Eine sortierbare Liste der Nutzer-Apps wird angezeigt.
3. Für jede App in der Liste:
   • Klicken Sie auf den Link Bearbeiten, um die App-Eigenschaften zu bearbeiten.
   • Wählen Sie den Link Löschen aus, um die App zu löschen.

Nutzerkonto kündigen

Ein Portaladministrator kann ein Nutzerkonto kündigen. Der Administrator kann ein einzelnes Konto oder mehrere Konten gleichzeitig auflösen.

So kündigen Sie einzelne Nutzerkonten:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Personen aus.
3. Wählen Sie in der Spalte Vorgänge der Tabelle mit den Nutzern die Option Konto kündigen aus.
4. Klicken Sie unter „Wenn ein Nutzerkonto gekündigt wird“ auf die entsprechende Option. Folgende Optionen sind verfügbar:
   • Konto deaktivieren und Inhalte beibehalten: (Standardeinstellung) Das Nutzerkonto und die zugehörigen Inhalte bleiben erhalten. Das Nutzerkonto ist jedoch vom Zugriff auf API-Ressourcen ausgeschlossen. Das ist die Standardeinstellung. Ein Administrator kann die Blockierung des Nutzerkontos später aufheben.
   • Konto deaktivieren und Inhalten die Veröffentlichung entziehen:Das Nutzerkonto bleibt erhalten. Inhalte, die mit dem Nutzerkonto verknüpft sind, werden jedoch entfernt. Das Nutzerkonto ist für den Zugriff auf API-Ressourcen gesperrt. Ein Administrator kann die Blockierung des Nutzerkontos später aufheben.
   • Konto löschen, aber die Inhalte dem anonymen Nutzer zuordnen: Das Nutzerkonto wird gelöscht. Mit dem Nutzerkonto verknüpfte Inhalte bleiben erhalten, werden aber mit dem Nutzerkonto „Anonym“ verknüpft, also mit einem Konto, das nicht authentifiziert wurde. Das Nutzerkonto kann nicht wieder aktiviert werden. Der Nutzer muss sich neu registrieren und sein Konto muss authentifiziert werden, bevor er auf API-Ressourcen zugreifen kann.
   • Konto und zugehörige Inhalte löschen: Das Nutzerkonto und die zugehörigen Inhalte werden gelöscht. Das Nutzerkonto kann nicht wieder aktiviert werden. Der Nutzer muss sich neu registrieren und sein Konto muss authentifiziert werden, bevor er auf API-Ressourcen zugreifen kann.
5. Wenn der Nutzer eine E-Mail mit der Aufforderung erhalten soll, die Kündigung zu bestätigen, wählen Sie E-Mail-Bestätigung für die Kontoauflösung erforderlich aus.
   Wenn Sie diese Option auswählen, muss das Konto des Nutzers die richtigen Berechtigungen haben, damit die Kündigung möglich ist. Wählen Sie Personen > Berechtigungen aus und prüfen Sie, ob für die Rolle authentifizierter Nutzer die Berechtigung Eigenes Nutzerkonto kündigen festgelegt ist.
6. Klicken Sie auf Konto auflösen.

So kündigen Sie mehrere Nutzerkonten:

1. Melden Sie sich im Portal als Nutzer mit Administratorberechtigungen an.
2. Wählen Sie im Drupal-Verwaltungsmenü Personen aus.
3. Wählen Sie unter Vorgänge im Drop-down-Menü die Option Nutzerkonto kündigen aus.
4. Klicken Sie das Kästchen neben jedem Nutzer an, dessen Konto Sie kündigen möchten.
5. Klicken Sie auf die Schaltfläche Ausführen.
6. Klicken Sie unter „Wenn ein Nutzerkonto gekündigt wird“ auf die entsprechende Option. Folgende Optionen sind verfügbar:
   • Deaktivieren Sie das Konto und bewahren Sie die Inhalte auf.
   • Deaktivieren Sie das Konto und entfernen Sie die Veröffentlichung der Inhalte.
   • Das Konto löschen, aber die Inhalte dem anonymen Nutzer zuordnen
   • Löschen Sie das Konto und seinen Inhalt.
7. Klicken Sie auf Weiter.
8. Klicken Sie auf Bestätigen.

Standardaktion für die Kontoauflösung festlegen

Administratoren des Entwicklerportals können die Standardaktion des Portals festlegen, wenn ein Nutzerkonto gekündigt wird.

So legen Sie die Standardaktion fest, wenn ein Konto gekündigt wird:

1. Melden Sie sich als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten in Ihrem Portal an.
2. Wählen Sie im Drupal-Verwaltungsmenü Konfiguration aus.
3. Wählen Sie Kontoeinstellungen aus.
4. Klicken Sie im Abschnitt „Registrierung und Kündigung“ unter „Bei Kündigung eines Nutzerkontos“ auf die entsprechende Kündigungsoption. Folgende Optionen sind verfügbar:
   • Deaktivieren Sie das Konto und bewahren Sie die Inhalte auf.
   • Deaktivieren Sie das Konto und entfernen Sie die Veröffentlichung der Inhalte.
   • Das Konto löschen, aber die Inhalte dem anonymen Nutzer zuordnen
   • Löschen Sie das Konto und seinen Inhalt.
5. Klicken Sie auf Speichern.