correctly add new service

Signed-off-by: Jörn Friedrich Dreyer <jfd@butonic.de>

.drone.star

@@ -68,6 +68,7 @@ config = {
         "services/groups",
         "services/idm",
         "services/idp",
+        "services/invitations",
         "services/nats",
         "services/notifications",
         "services/ocdav",

Makefile

@@ -32,6 +32,7 @@ OCIS_MODULES = \
 	services/groups \
 	services/idm \
 	services/idp \
+	services/invitations \
 	services/nats \
 	services/notifications \
 	services/ocdav \

docs/services/invitations/_index.md

@@ -0,0 +1,16 @@
+---
+title: IDP
+weight: 20
+geekdocRepo: https://github.com/owncloud/ocis
+geekdocEditPath: edit/master/docs/services/invitations
+geekdocFilePath: _index.md
+geekdocCollapseSection: true
+---
+
+## Abstract
+
+This service provides an invitations service to invite guests into the organization.
+
+## Table of Contents
+
+{{< toc-tree >}}

docs/services/invitations/configuration.md

@@ -0,0 +1,15 @@
+---
+title: Service Configuration
+date: 2023-03-02T15:27:00+01:00
+weight: 20
+geekdocRepo: https://github.com/owncloud/ocis
+geekdocEditPath: edit/master/docs/services/invitations
+geekdocFilePath: configuration.md
+geekdocCollapseSection: true
+---
+
+## Example YAML Config
+
+{{< include file="services/_includes/invitations-config-example.yaml"  language="yaml" >}}
+
+{{< include file="services/_includes/invitations_configvars.md" >}}

services/invitations/README.md

@@ -4,4 +4,14 @@ The invitations service provides an [Invitation Manager](https://learn.microsoft
 
 Users invited via this Invitation Manager (libre graph API) will have `userType="Guest"`, whereas users belonging to the organization have `userType="Member"`.
 
-The corresponding CS3 API [user types](https://cs3org.github.io/cs3apis/#cs3.identity.user.v1beta1.UserType) used to reperesent this are: `USER_TYPE_GUEST` and `USER_TYPE_PRIMARY`.
+The corresponding CS3 API [user types](https://cs3org.github.io/cs3apis/#cs3.identity.user.v1beta1.UserType) used to reperesent this are: `USER_TYPE_GUEST` and `USER_TYPE_PRIMARY`.
+
+
+## Provisioning backends
+
+When oCIS is used for user management the users are created using the `/graph/v1.0/users` endpoint. For larger deployments the keycloak admin API can be used to provision users. We might even make the endpoint, credentials and body configurable using templates.
+
+
+## Bridging provisioning delay
+
+When a guest account has to be provisioned in an external user management there might be a delay between creating the user and it being available in the local ocis system. In the first iteration the invitations service will only keep track of invites in memory. This list could be persisted in future iterations.