]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add German translation for `docs/de/docs/tutorial/security/index.md` (#10429)
authorNils Lindemann <nilslindemann@tutanota.com>
Sat, 30 Mar 2024 18:09:35 +0000 (19:09 +0100)
committerGitHub <noreply@github.com>
Sat, 30 Mar 2024 18:09:35 +0000 (13:09 -0500)
docs/de/docs/tutorial/security/index.md [new file with mode: 0644]

diff --git a/docs/de/docs/tutorial/security/index.md b/docs/de/docs/tutorial/security/index.md
new file mode 100644 (file)
index 0000000..7a11e70
--- /dev/null
@@ -0,0 +1,101 @@
+# Sicherheit
+
+Es gibt viele Wege, Sicherheit, Authentifizierung und Autorisierung zu handhaben.
+
+Und normalerweise ist es ein komplexes und â€žschwieriges“ Thema.
+
+In vielen Frameworks und Systemen erfordert allein die Handhabung von Sicherheit und Authentifizierung viel Aufwand und Code (in vielen FĂ€llen kann er 50 % oder mehr des gesamten geschriebenen Codes ausmachen).
+
+**FastAPI** bietet mehrere Tools, die Ihnen helfen, schnell und auf standardisierte Weise mit **Sicherheit** umzugehen, ohne alle Sicherheits-Spezifikationen studieren und erlernen zu mĂŒssen.
+
+Aber schauen wir uns zunĂ€chst ein paar kleine Konzepte an.
+
+## In Eile?
+
+Wenn Ihnen diese Begriffe egal sind und Sie einfach *jetzt* Sicherheit mit Authentifizierung basierend auf Benutzername und Passwort hinzufĂŒgen mĂŒssen, fahren Sie mit den nĂ€chsten Kapiteln fort.
+
+## OAuth2
+
+OAuth2 ist eine Spezifikation, die verschiedene Möglichkeiten zur Handhabung von Authentifizierung und Autorisierung definiert.
+
+Es handelt sich um eine recht umfangreiche Spezifikation, und sie deckt mehrere komplexe AnwendungsfĂ€lle ab.
+
+Sie umfasst Möglichkeiten zur Authentifizierung mithilfe eines â€žDritten“ („third party“).
+
+Das ist es, was alle diese â€žLogin mit Facebook, Google, Twitter, GitHub“-Systeme unter der Haube verwenden.
+
+### OAuth 1
+
+Es gab ein OAuth 1, das sich stark von OAuth2 unterscheidet und komplexer ist, da es direkte Spezifikationen enthĂ€lt, wie die Kommunikation verschlĂŒsselt wird.
+
+Heutzutage ist es nicht sehr populĂ€r und wird kaum verwendet.
+
+OAuth2 spezifiziert nicht, wie die Kommunikation verschlĂŒsselt werden soll, sondern erwartet, dass Ihre Anwendung mit HTTPS bereitgestellt wird.
+
+!!! tip "Tipp"
+    Im Abschnitt ĂŒber **Deployment** erfahren Sie, wie Sie HTTPS mithilfe von Traefik und Let's Encrypt kostenlos einrichten.
+
+
+## OpenID Connect
+
+OpenID Connect ist eine weitere Spezifikation, die auf **OAuth2** basiert.
+
+Sie erweitert lediglich OAuth2, indem sie einige Dinge spezifiziert, die in OAuth2 relativ mehrdeutig sind, um zu versuchen, es interoperabler zu machen.
+
+Beispielsweise verwendet der Google Login OpenID Connect (welches seinerseits OAuth2 verwendet).
+
+Aber der Facebook Login unterstĂŒtzt OpenID Connect nicht. Es hat seine eigene Variante von OAuth2.
+
+### OpenID (nicht â€žOpenID Connect“)
+
+Es gab auch eine â€žOpenID“-Spezifikation. Sie versuchte das Gleiche zu lösen wie **OpenID Connect**, basierte aber nicht auf OAuth2.
+
+Es handelte sich also um ein komplett zusĂ€tzliches System.
+
+Heutzutage ist es nicht sehr populĂ€r und wird kaum verwendet.
+
+## OpenAPI
+
+OpenAPI (frĂŒher bekannt als Swagger) ist die offene Spezifikation zum Erstellen von APIs (jetzt Teil der Linux Foundation).
+
+**FastAPI** basiert auf **OpenAPI**.
+
+Das ist es, was erlaubt, mehrere automatische interaktive Dokumentations-OberflĂ€chen, Codegenerierung, usw. zu haben.
+
+OpenAPI bietet die Möglichkeit, mehrere Sicherheits„systeme“ zu definieren.
+
+Durch deren Verwendung können Sie alle diese Standards-basierten Tools nutzen, einschließlich dieser interaktiven Dokumentationssysteme.
+
+OpenAPI definiert die folgenden Sicherheitsschemas:
+
+* `apiKey`: ein anwendungsspezifischer SchlĂŒssel, der stammen kann von:
+    * Einem Query-Parameter.
+    * Einem Header.
+    * Einem Cookie.
+* `http`: Standard-HTTP-Authentifizierungssysteme, einschließlich:
+    * `bearer`: ein Header `Authorization` mit dem Wert `Bearer` plus einem Token. Dies wird von OAuth2 geerbt.
+    * HTTP Basic Authentication.
+    * HTTP Digest, usw.
+* `oauth2`: Alle OAuth2-Methoden zum Umgang mit Sicherheit (genannt â€žFlows“).
+    * Mehrere dieser Flows eignen sich zum Aufbau eines OAuth 2.0-Authentifizierungsanbieters (wie Google, Facebook, Twitter, GitHub usw.):
+        * `implicit`
+        * `clientCredentials`
+        * `authorizationCode`
+    * Es gibt jedoch einen bestimmten â€žFlow“, der perfekt fĂŒr die direkte Abwicklung der Authentifizierung in derselben Anwendung verwendet werden kann:
+        * `password`: Einige der nĂ€chsten Kapitel werden Beispiele dafĂŒr behandeln.
+* `openIdConnect`: bietet eine Möglichkeit, zu definieren, wie OAuth2-Authentifizierungsdaten automatisch ermittelt werden können.
+    * Diese automatische Erkennung ist es, die in der OpenID Connect Spezifikation definiert ist.
+
+
+!!! tip "Tipp"
+    Auch die Integration anderer Authentifizierungs-/Autorisierungsanbieter wie Google, Facebook, Twitter, GitHub, usw. ist möglich und relativ einfach.
+
+    Das komplexeste Problem besteht darin, einen Authentifizierungs-/Autorisierungsanbieter wie solche aufzubauen, aber **FastAPI** reicht Ihnen die Tools, das einfach zu erledigen, wĂ€hrend Ihnen die schwere Arbeit abgenommen wird.
+
+## **FastAPI** Tools
+
+FastAPI stellt fĂŒr jedes dieser Sicherheitsschemas im Modul `fastapi.security` verschiedene Tools bereit, die die Verwendung dieser Sicherheitsmechanismen vereinfachen.
+
+In den nĂ€chsten Kapiteln erfahren Sie, wie Sie mit diesen von **FastAPI** bereitgestellten Tools Sicherheit zu Ihrer API hinzufĂŒgen.
+
+Und Sie werden auch sehen, wie dies automatisch in das interaktive Dokumentationssystem integriert wird.