From 91fd46148e46aac28a7d8d2b827f212d63793d87 Mon Sep 17 00:00:00 2001 From: jjeroch <94133633+jjeroch@users.noreply.github.com> Date: Mon, 27 May 2024 14:46:21 +0200 Subject: [PATCH] docs(feat): add credential revocation (#325) --- .../04. Credential Revocation.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 docs/user/06. Certificates/04. Credential Revocation.md diff --git a/docs/user/06. Certificates/04. Credential Revocation.md b/docs/user/06. Certificates/04. Credential Revocation.md new file mode 100644 index 000000000..cd6260343 --- /dev/null +++ b/docs/user/06. Certificates/04. Credential Revocation.md @@ -0,0 +1,42 @@ +## Credential Revocation + +### Overview + +The credential revocation function allows authorized individuals to revoke issued credentials that are currently active. This action is irreversible and will invalidate the credential, ensuring it is no longer recognized as valid within any transactions. + +### How to Revoke a Credential + +If you have been granted the "revoke_credentials_issuer" permission, you can revoke active credentials via the issuer admin board. Follow the steps below to carry out a revocation: + +1. **Locate the Credential**: Navigate to the issuer admin board and find the active credential you wish to revoke. + +2. **Initiate Revocation**: Click on the revoke icon (represented by a circular arrow) next to the credential you want to revoke. + + image + +3. **Confirm Your Action**: After clicking the revoke icon, a confirmation overlay will appear. Carefully review the details, then select "Confirm" to proceed with the revocation or "Cancel" to abort the process. + + image + +4. **Revocation Process**: A loading indicator will appear while the system processes the revocation. Once complete, you will receive a notification indicating the outcome of your action. + +### Notifications + +- **Success**: You will receive a confirmation message stating that the credential has been successfully revoked and is no longer valid. +- **Error**: If the revocation fails, an error message will be displayed advising you to try again later or contact the site administrator. + +### Important Considerations + +- **Irreversible Action**: Revocation is a permanent action. Once a credential is revoked, it cannot be reinstated as valid. +- **Permission Required**: Only users with the "revoke_credentials_issuer" permission can perform revocations. +- **Immediate Effect**: The revocation takes effect immediately, and the credential's status will be updated to reflect this change. + +
+ +## 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: 2024 Contributors to the Eclipse Foundation +- Source URL: https://github.com/eclipse-tractusx/portal-assets