feat: add web app howto.

Author: asaf

docs/guides/howto/add_web_app.md

@@ -0,0 +1,29 @@
+---
+id: add_web_app
+title: Add a Web Application.
+sidebar_label: Add Web App
+slug: /guides/howto/add-web-app
+description: How to let Crossid know about your Single Page Application (SPA).
+---
+
+import AddWebApp from "../../../src/components/AddWebApp.mdx";
+
+### What is an app?
+
+An _app_ represents your application where users logs in.
+
+This explains how to add a web app, used by backends such as _Nodejs_ and _Golang_, etc...
+
+:::note
+For other app types, see [application](/docs/concepts/application).
+:::
+
+## Adding an app
+
+<AddWebApp/>
+
+Crossid will give you back _client id_ and _client_secret_ to be embedded into your app's code.
+
+## Update your app
+
+Everytime a user tries to login, the app should redirect to Crossid and provide the _client id_.

sidebars.js

@@ -13,6 +13,7 @@ module.exports = {
         ],
         "How-Tos": [
           "guides/howto/add_spa_app",
+          "guides/howto/add_web_app",
           "guides/howto/app_user_assignment",
         ],
       },

src/components/AddSpaApp.mdx

@@ -24,29 +24,56 @@ curl -X POST \
 -H "Authorization: Bearer <API_TOKEN>" \
 -d '
 {
-  "type": "singlePageApp",
-  "data": [
-    {
-      "collectorId": "appDetails",
-      "vars": {
-        "displayName": "My App",
-        "appId": "myapp"
-      }
-    },
-    {
-      "collectorId": "oauth2Client",
-      "type": "oauth2Client",
-      "vars": {
-        "client_id": "myapp",
-        "redirect_uris": [
-          "https://localhost/callback"
-        ],
-        "audience": ["https://localhost"]
+   "type":"singlePageApp",
+   "data":[
+      {
+         "type":"appManifest",
+         "collectorId":"appDetails",
+         "vars":{
+            "appId":"myspa",
+            "displayName":"My SPA",
+            "active":true,
+            "appLogic":"local",
+            "types":[
+               "scimGroup",
+               "userLink"
+            ]
+         }
+      },
+      {
+         "type":"info",
+         "collectorId":"overview",
+         "vars":{
+
+         }
+      },
+      {
+         "type":"default",
+         "collectorId":"oauth2Client",
+         "vars":{
+            "grant_types":[
+               "authorization_code"
+            ],
+            "response_types":[
+               "code"
+            ],
+            "scope":"openid offline profile email",
+            "token_endpoint_auth_method":"none",
+            "allow_refresh_token":false,
+            "redirect_uris":[
+               "https://localhost/callback"
+            ],
+            "post_logout_redirect_uris":[
+               "https://localhost/callback"
+            ],
+            "allowed_cors_origins":[
+               "https://localhost*"
+            ]
+         }
       }
-    }
-  ]
+   ]
 }
-' https://{tenant}.crossid.io/api/v1/apps/.provision/?reason=sample-app
+' https://{tenant}.crossid.io/api/v1/integrations/.provision/?reason=sample-app
 ```
 
 </TabItem>

src/components/AddWebApp.mdx

@@ -0,0 +1,77 @@
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+<Tabs
+defaultValue="console"
+values={[
+{label: 'Console', value: 'console'},
+{label: 'Curl', value: 'curl'}
+]}>
+<TabItem value="console">
+
+1. In Admin console, navigate to <b>Integration &rarr; Marketplace</b>.
+1. Choose <b>Web Page Application</b>.
+1. Click on <b>Add Integration</b>.
+1. Follow wizard steps.
+
+![how-to](/img/add_web_app.gif)
+
+</TabItem>
+<TabItem value="curl">
+
+```bash {10-11,18-22}
+curl -X POST \
+-H "Authorization: Bearer <API_TOKEN>" \
+-d '
+{
+   "type":"webApp",
+   "data":[
+      {
+         "type":"appManifest",
+         "collectorId":"appDetails",
+         "vars":{
+            "appId":"mynodeapp",
+            "displayName":"My Node App",
+            "active":true,
+            "appLogic":"scimv2",
+            "types":[
+               "scimGroup",
+               "userLink"
+            ]
+         }
+      },
+      {
+         "type":"info",
+         "collectorId":"overview",
+         "vars":{
+
+         }
+      },
+      {
+         "type":"default",
+         "collectorId":"oauth2Client",
+         "vars":{
+            "grant_types":[
+               "authorization_code"
+            ],
+            "response_types":[
+               "code",
+               "id_token",
+               "code id_token"
+            ],
+            "scope":"openid offline profile email",
+            "redirect_uris":[
+               "https://localhost/callback"
+            ],
+            "post_logout_redirect_uris":[
+               "https://localhost/callback"
+            ]
+         }
+      }
+   ]
+}
+' https://{tenant}.crossid.io/api/v1/integrations/.provision/?reason=sample-app
+```
+
+</TabItem>
+</Tabs>