diff --git a/.idea/misc.xml b/.idea/misc.xml
index b8bd0ad2..74b659b2 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -9,7 +9,7 @@
-
+
diff --git a/buildSrc/src/main/kotlin/zakadabar/gradle/Versions.kt b/buildSrc/src/main/kotlin/zakadabar/gradle/Versions.kt
index fadaa8b6..b7f68ee8 100644
--- a/buildSrc/src/main/kotlin/zakadabar/gradle/Versions.kt
+++ b/buildSrc/src/main/kotlin/zakadabar/gradle/Versions.kt
@@ -4,7 +4,7 @@
package zakadabar.gradle
object Versions {
- const val zakadabar = "2023.1.10-SNAPSHOT"
+ const val zakadabar = "2023.2.10-SNAPSHOT"
val isSnapshot = zakadabar.contains("SNAPSHOT")
diff --git a/doc/changelog/TOC.md b/doc/changelog/TOC.md
index 9f63b820..b6c459a6 100644
--- a/doc/changelog/TOC.md
+++ b/doc/changelog/TOC.md
@@ -1,5 +1,6 @@
-* [2023.1.9](./archive/2023.1.9.md)
+* [2023.2.10](./archive/2023.2.10.md)
* [Archive]()
+ * [2023.2.10](./archive/2023.2.10.md)
* [2023.1.9](./archive/2023.1.9.md)
* [2022.12.13](./archive/2022.12.13.md)
* [2022.11.9](./archive/2022.11.9.md)
diff --git a/doc/changelog/archive/2023.2.10.md b/doc/changelog/archive/2023.2.10.md
new file mode 100644
index 00000000..7763b7d4
--- /dev/null
+++ b/doc/changelog/archive/2023.2.10.md
@@ -0,0 +1,11 @@
+# 2023.2.10
+
+## Legend
+
+Changes with marker **very low** and such are technically breaking changes. However, they are
+not major modifications and in most cases they should not break anything. Notes after the marker
+are the places worth to check. If you extended them you may have to apply the change to your own class also.
+
+## Lib: Account
+
+- add OAuth authentication and registration
\ No newline at end of file
diff --git a/doc/guides/TOC.md b/doc/guides/TOC.md
index 7ac249d6..7efcc592 100644
--- a/doc/guides/TOC.md
+++ b/doc/guides/TOC.md
@@ -48,6 +48,7 @@
* [Introduction](./libraries/accounts/Introduction.md)
* [Use](./libraries/accounts/Use.md)
* [Sessions](./libraries/accounts/Sessions.md)
+ * [OAuth](./libraries/accounts/Oauth.md)
* [Blobs]()
* [Introduction](./libraries/blobs/Introduction.md)
* [E-mail]()
diff --git a/doc/guides/libraries/accounts/Oauth.md b/doc/guides/libraries/accounts/Oauth.md
index 2d587103..17f7763f 100644
--- a/doc/guides/libraries/accounts/Oauth.md
+++ b/doc/guides/libraries/accounts/Oauth.md
@@ -1,16 +1,18 @@
-# OAuth2 authentication
+# OAuth2 Authentication
This lib supports Oauth2 authentication method with id_token processing.
-## configure settings
+## Settings
-Config section is in the 'lib.accounts.yaml' under the optional 'oauth' key
+Config section is in `lib.accounts.yaml` under the optional `oauth` key. See
+[ModuleSettings](/lib/accounts/src/commonMain/kotlin/zakadabar/lib/accounts/data/ModuleSettings.kt)
+for general information.
-### Oauth2 related parameters
+- multiple providers are allowed
+- claims are mapped to local db AccountPrivate fields
-For details see [ModuleSettings](/lib/accounts/src/commonMain/kotlin/zakadabar/lib/accounts/data/ModuleSettings.kt)
+Sample yaml section using google's provider:
-sample yaml section using google's provider
```yaml
oauth:
-
@@ -31,10 +33,10 @@ oauth:
fullName: name
email: email
```
-- multiple providers are allowed
-- claims are mapped to local db AccountPrivate fields
-### login and callback endpoints
+### Login And Callback Endpoints
+
+Login endpoint:
/api/auth//login
@@ -42,13 +44,14 @@ Browser redirects to provider's authorizationEndpoint.
/api/auth//callback
-Provider redirects back here after authentication.
+The provider redirects back here after authentication.
+
Callback URL with full protocol and host declaration must be registered as allowed redirect_url in the provider.
After successful authentication a session created for authenticated user and the browser redirects again to the root page.
-### external app (android app) using this provider
+### Using From External App (Android)
-login syntax:
+Login syntax:
/api/auth//login?app=
@@ -59,8 +62,9 @@ After successful authentication the app with following parameter syntax will ope
Inside the app using sessionKey as cookie name and sessionId as cookie value allows communication in authorized session.
The external-app-link must be in the configuration yaml externalApps list. It can be app-link or deep-link.
-### Extra validations
-If the project requires additional checking, there is a callback option
+### Extra Validations
+
+If the project requires additional checking, there is a callback option:
```kotlin
val authBl by module()
@@ -72,4 +76,4 @@ If the project requires additional checking, there is a callback option
}
```
-This callback be called after processing request and before creating authenticated session.
\ No newline at end of file
+This callback is called after oauth processing and before creating authenticated session.
\ No newline at end of file