chore: move iam specific docu from assets to iam (#31)

* move iam specific docu from assets to iam * adjust upgrade docu * add licenses for images * add license header to notice script * adjust role and rights images * add check for license info, headers, footers and files to pr template * adjust faqs --------- Refs: CPLP-3059 Co-authored-by: Evelyn Gurschler <[email protected]> Reviewed-by: Evelyn Gurschler <[email protected]>
eclipse-tractusx · Nov 27, 2023 · 56690ba · 56690ba
1 parent 8500085
commit 56690ba
Show file tree

Hide file tree

Showing 100 changed files with 1,732 additions and 6 deletions.
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -15,7 +15,7 @@ Link to Github issue.
 Please delete options that are not relevant.
 
 - [ ] I have followed the [contributing guidelines](https://github.com/eclipse-tractusx/portal-assets/blob/main/developer/Technical%20Documentation/Dev%20Process/How%20to%20contribute.md#commit-and-pr-guidelines)
-- [ ] I have added a copyright and license header in all affected files
+- [ ] I have added copyright and license headers, footers (for .md files) or files (for images) 
 - [ ] I have performed a self-review of my changes
 - [ ] I have successfully tested my changes
 - [ ] I have added comments in the default values.yaml file with helm-docs syntax ('# -- ') if relevant for installation

diff --git a/docs/consultation/consultation.md b/docs/consultation/consultation.md
@@ -112,4 +112,4 @@ This work is licensed under the [Apache-2.0](https://www.apache.org/licenses/LIC
 
 - SPDX-License-Identifier: Apache-2.0
 - SPDX-FileCopyrightText: 2021-2023 Contributors to the Eclipse Foundation
-- Source URL: https://github.com/eclipse-tractusx/portal-iam
+- Source URL: https://github.com/eclipse-tractusx/portal-iam
diff --git a/docs/consultation/workshop-20230927.md b/docs/consultation/workshop-20230927.md
@@ -6,7 +6,7 @@
 
 ### Overall System Diagram
 
-![Overall System Diagram](./img/overall-system.png)
+![Overall System Diagram](/docs/static/overall-system.png)
 
 Portal IdP is formed by two Keycloak instances:
 
@@ -17,7 +17,7 @@ Portal IdP is formed by two Keycloak instances:
 * Shared IdP
     * User management
 
-![Portal IdP Workflow](./img/portal-idp.png)
+![Portal IdP Workflow](/docs/static/portal-idp.png)
 
 The high level Auth/Authz workflow is:
 

diff --git a/docs/static/2-factor-auth.png b/docs/static/2-factor-auth.png
diff --git a/docs/static/2-factor-auth.png.license b/docs/static/2-factor-auth.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/add-idp.png b/docs/static/add-idp.png
diff --git a/docs/static/add-idp.png.license b/docs/static/add-idp.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/add-provider-menu.png b/docs/static/add-provider-menu.png
diff --git a/docs/static/add-provider-menu.png.license b/docs/static/add-provider-menu.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/auth-flow.png b/docs/static/auth-flow.png
diff --git a/docs/static/auth-flow.png.license b/docs/static/auth-flow.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/authentication-flow.png b/docs/static/authentication-flow.png
diff --git a/docs/static/authentication-flow.png.license b/docs/static/authentication-flow.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/authentication-protocol.png b/docs/static/authentication-protocol.png
diff --git a/docs/static/authentication-protocol.png.license b/docs/static/authentication-protocol.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/bpdm-gate-overview.png b/docs/static/bpdm-gate-overview.png
diff --git a/docs/static/bpdm-gate-overview.png.license b/docs/static/bpdm-gate-overview.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/bpdm-pool-overview.png b/docs/static/bpdm-pool-overview.png
diff --git a/docs/static/bpdm-pool.png.license b/docs/static/bpdm-pool.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/bpn.png b/docs/static/bpn.png
diff --git a/docs/static/bpn.png.license b/docs/static/bpn.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/brute-force.png b/docs/static/brute-force.png
diff --git a/docs/static/brute-force.png.license b/docs/static/brute-force.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/client-authentication-concept.png b/docs/static/client-authentication-concept.png
diff --git a/docs/static/client-authentication-concept.png.license b/docs/static/client-authentication-concept.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/client-data.png b/docs/static/client-data.png
diff --git a/docs/static/client-data.png.license b/docs/static/client-data.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/client-roles.png b/docs/static/client-roles.png
diff --git a/docs/static/client-roles.png.license b/docs/static/client-roles.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/common-parameters.png b/docs/static/common-parameters.png
diff --git a/docs/static/common-parameters.png.license b/docs/static/common-parameters.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/composite-roles.png b/docs/static/composite-roles.png
diff --git a/docs/static/composite-roles.png.license b/docs/static/composite-roles.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/create-user.png b/docs/static/create-user.png
diff --git a/docs/static/create-user.png.license b/docs/static/create-user.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/event-config.png b/docs/static/event-config.png
diff --git a/docs/static/event-config.png.license b/docs/static/event-config.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/first-login-flow.png b/docs/static/first-login-flow.png
diff --git a/docs/static/first-login-flow.png.license b/docs/static/first-login-flow.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/identity-providers.png b/docs/static/identity-providers.png
diff --git a/docs/static/identity-providers.png.license b/docs/static/identity-providers.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/import-external-idp-config.png b/docs/static/import-external-idp-config.png
diff --git a/docs/static/import-external-idp-config.png.license b/docs/static/import-external-idp-config.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/login-event-filter.png b/docs/static/login-event-filter.png
diff --git a/docs/static/login-event-filter.png.license b/docs/static/login-event-filter.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/login-events.png b/docs/static/login-events.png
diff --git a/docs/static/login-events.png.license b/docs/static/login-events.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/managed-wallets-overview.png b/docs/static/managed-wallets-overview.png
diff --git a/docs/static/managed-wallets-overview.png.license b/docs/static/managed-wallets-overview.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/mappers.png b/docs/static/mappers.png
diff --git a/docs/static/mappers.png.license b/docs/static/mappers.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/new-flow.png b/docs/static/new-flow.png
diff --git a/docs/static/new-flow.png.license b/docs/static/new-flow.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/consultation/img/overall-system.png → docs/static/overall-system.png b/docs/consultation/img/overall-system.png → docs/static/overall-system.png
diff --git a/...nsultation/img/overall-system.png.license → docs/static/overall-system.png.license b/...nsultation/img/overall-system.png.license → docs/static/overall-system.png.license
@@ -2,4 +2,5 @@ This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses
 
 - SPDX-License-Identifier: CC-BY-4.0
 - SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
-- Source URL: https://github.com/eclipse-tractusx/portal-iam
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/password-policy.png b/docs/static/password-policy.png
diff --git a/docs/static/password-policy.png.license b/docs/static/password-policy.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/password-recovery.png b/docs/static/password-recovery.png
diff --git a/docs/static/password-recovery.png.license b/docs/static/password-recovery.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/portal-application-overview.png b/docs/static/portal-application-overview.png
diff --git a/docs/static/portal-application-overview.png.license b/docs/static/portal-application-overview.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/consultation/img/portal-idp.png → docs/static/portal-idp.png b/docs/consultation/img/portal-idp.png → docs/static/portal-idp.png
diff --git a/docs/consultation/img/portal-idp.png.license → docs/static/portal-idp.png.license b/docs/consultation/img/portal-idp.png.license → docs/static/portal-idp.png.license
@@ -2,4 +2,5 @@ This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses
 
 - SPDX-License-Identifier: CC-BY-4.0
 - SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
-- Source URL: https://github.com/eclipse-tractusx/portal-iam
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/registration-application-overview.png b/docs/static/registration-application-overview.png
diff --git a/docs/static/registration-application-overview.png.license b/docs/static/registration-application-overview.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/required-authenticaction.png b/docs/static/required-authenticaction.png
diff --git a/docs/static/required-authenticaction.png.license b/docs/static/required-authenticaction.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/roles-permissions.png b/docs/static/roles-permissions.png
diff --git a/docs/static/roles-permissions.png.license b/docs/static/roles-permissions.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/save-events.png b/docs/static/save-events.png
diff --git a/docs/static/save-events.png.license b/docs/static/save-events.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/scenario1.png b/docs/static/scenario1.png
diff --git a/docs/static/scenario1.png.license b/docs/static/scenario1.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/scenario2-1.png b/docs/static/scenario2-1.png
diff --git a/docs/static/scenario2-1.png.license b/docs/static/scenario2-1.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/scenario2.png b/docs/static/scenario2.png
diff --git a/docs/static/scenario2.png.license b/docs/static/scenario2.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/technical-user-accounts-overview.png b/docs/static/technical-user-accounts-overview.png
diff --git a/docs/static/technical-user-accounts-overview.png.license b/docs/static/technical-user-accounts-overview.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/technical-user-overview.png b/docs/static/technical-user-overview.png
diff --git a/docs/static/technical-user-overview.png.license b/docs/static/technical-user-overview.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/tokens.png b/docs/static/tokens.png
diff --git a/docs/static/tokens.png.license b/docs/static/tokens.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/static/users-view.png b/docs/static/users-view.png
diff --git a/docs/static/users-view.png.license b/docs/static/users-view.png.license
@@ -0,0 +1,6 @@
+This work is licensed under the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
+
+- SPDX-License-Identifier: CC-BY-4.0
+- SPDX-FileCopyrightText: Copyright (c) 2021, 2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-assets
+
diff --git a/docs/technical documentation/00. External Identity Provider.md b/docs/technical documentation/00. External Identity Provider.md
@@ -0,0 +1,50 @@
+# External Identity Provider
+
+For federated identities, external identity providers are needed.
+To support the external identity provider configuration, a user interface flow [Technical Integration IdP](https://github.com/eclipse-tractusx/portal-assets/tree/v1.6.1/developer/02.%20Technical%20Integration/02.%20Identity%20Provider%20Management) is implement in the Portal with which company admins can create / configure the company IdP as external IdP.
+For details, please follow the provided link.
+
+## How does the external IdP connection work?
+
+External company IdPs are getting similarly configured similarly to the sharedIdP which is configured for all companies using the Catena-X IdP as authentication provider.
+The company idP is created as external IdP inside the "Identity Provider" menu of the central realm.
+
+![identityProviders](/docs/static/identity-providers.png)
+
+Keycloak does in general support a huge number of idp(s) - however for Catena-X social network IdPs as well as SAML connections are not planned to get supported. Instead all connections are considered as OIDC connections.
+
+![addProviderMenu](/docs/static/add-provider-menu.png)
+
+IdPs are created with the following parameter
+
+- Alias (unique name)
+- Display Name (IdP display name in the login page)
+- Metadata URL (metadata url of the external IdP for automatic configuration)
+
+![addIdp](/docs/static/add-idp.png)
+
+![importExternalIdpConfig](/docs/static/import-external-idp-config.png)
+
+To ensure that the auto user creation is disabled (important to not generate a out of sync mode between the Keycloak db and portal db) the "First Login Flow" need to get set to "Login without auto user creation" (customized theme create by CX consortia and part of the release package).
+
+![firstLoginFlow](/docs/static/first-login-flow.png)
+
+Last but not least the client id and secret of the external IdP is needed to establish the trust between both the IdPs.
+
+![client-data](/docs/static/client-data.png)
+
+After this generic settings are done, the idp is successfully configured.
+Each IdP will get automatically (when created via endpoint - which is strongly suggested to ensure a in-sync state of the Keycloak and portal db) generate the necessary mappers.
+IdP mappers are used to import OIDC ID/Access token claims into user attributes and user role mappings.
+
+![mappers](/docs/static/mappers.png)
+
+Individual mappers are possible, but not suggested.
+
+## NOTICE
+
+This work is licensed under the [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0).
+
+- SPDX-License-Identifier: Apache-2.0
+- SPDX-FileCopyrightText: 2021-2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-iam
diff --git a/docs/technical documentation/01. Introduction.md b/docs/technical documentation/01. Introduction.md
@@ -0,0 +1,22 @@
+## Identity & Access Management
+
+### As-Is Authentication Management
+
+Authentication Flow - User login to Catena-X
+
+![AuthenticationFlow](/docs/static/authentication-flow.png)
+
+\*(Schatten-) User: The „Schatten-User“ (shadow user) is defined as an empty User frame holding limited information. The actual user is managed in the respective Identity Provider.  
+The Schatten-User are always federated identities
+
+### Authentication Protocol - OpenID Connect (OIDC)
+
+![AuthenticationProtocol](/docs/static/authentication-protocol.png)
+
+## NOTICE
+
+This work is licensed under the [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0).
+
+- SPDX-License-Identifier: Apache-2.0
+- SPDX-FileCopyrightText: 2021-2023 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/portal-iam