Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify "application" in Identity docs #2630

Open
akeller opened this issue Sep 21, 2023 · 4 comments
Open

Clarify "application" in Identity docs #2630

akeller opened this issue Sep 21, 2023 · 4 comments
Assignees
Labels
component:docs Documentation improvements, including new or updated content component:identity Issues related with Identity project

Comments

@akeller
Copy link
Member

akeller commented Sep 21, 2023

  • Is "application" a Keycloak term? I see a 1:1 mapping here for our C8 components. Every component is an application. But Zeebe isn't in the screenshots, so does that not include Zeebe?
  • Do we have recommendations for the application type for each of our C8 components?

Originally posted by @akeller in #2587 (review)

@akeller akeller added component:identity Issues related with Identity project component:docs Documentation improvements, including new or updated content labels Sep 21, 2023
@dlavrenuek
Copy link
Contributor

@akeller Application is not a Keycloak but rather an Auth0 term. In Keycloak it is just a client.
Zeebe is not an application because users can not login into it and it also does not call other apis itself (as an M2M application would do). It just provides an API that can be interacted with, so in our architecture it is an API. Do you think that the current applications docs page should be further improved?

Do we have recommendations for the application type for each of our C8 components?
User should not try to modify or create any c8 applications, these are created/updated automatically by preconfigured data in Identity. We are working on support for generic OpenIDC providers without Keycloak, which would require manually creating each application, so documentation for clients would be part of it.

@akeller
Copy link
Member Author

akeller commented Oct 24, 2023

I recommend defining an "application" and maybe including where the name comes from (Auth0).

In the SaaS console, we refer to "Camunda apps" as Console, Modeler, Tasklist, Optimize, and Operate. I want to make sure we are clear about what we refer to when discussing applications and apps.

What does this page refer to? Why would I create a new application? A custom Tasklist implementation? Or is this pre-work for the generic OpenIDC provider task you referred to?

@dlavrenuek
Copy link
Contributor

As described on this page, there are 3 types of applications: public, confidential and m2m. Public and confidential applications are applications where a user can log in, this could be a custom Tasklist or any custom web-based (or even mobile) app, that needs to operate in the c8 context (f.e. use the Tasklist, Operate or Modeler APIs). An M2M application is an application that does not have a UI and just runs, f.e. a service worker.

The SaaS "Apps" are technically also applications. On SM we do not have the destinction between applications (c8 apps) and clients (other apps/workers). I can see that this can create confusions for users switching from SaaS to SM but also provides additional challenges in maintaining the docs.

When you say defining an "application", do you mean adding this as a term to glossary?

@akeller akeller mentioned this issue Oct 30, 2023
9 tasks
@akeller
Copy link
Member Author

akeller commented Oct 30, 2023

Let me do this in a PR. I think we have the pieces, but we need some links to bring things together.

@akeller akeller self-assigned this Oct 30, 2023
@akeller akeller moved this from 🆕 Inbox to 🏗 In Progress in Developer Experience Oct 30, 2023
@akeller akeller moved this from 🏗 In Progress to 🛑 Blocked in Developer Experience Dec 15, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:docs Documentation improvements, including new or updated content component:identity Issues related with Identity project
Projects
Status: 🛑 Blocked
Development

No branches or pull requests

2 participants