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

Batch of content to be uploaded #161

Merged
merged 7 commits into from
Aug 15, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 3 additions & 14 deletions docs/_index.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,9 @@
---
hide_title: true
sidebar_position: 1
sidebar_position: 0.5
sidebar_label: Home
---

<!-- [![Lifecycle:Experimental](https://img.shields.io/badge/Lifecycle-Experimental-339999)](<Redirect-URL>) -->
[![Lifecycle:Experimental](https://img.shields.io/badge/Lifecycle-Experimental-339999)](#)
Digital trust has created extensive resources—including tools, guidelines, and templates—to facilitate the adoption process. Currently, these valuable resources remain internal, accessible only through direct engagement with our team. This approach promotes considerable one-on-one support, resulting in bottlenecks for scaling our digital trust initiatives.

## Introduction

Each verifiable credential issued by the BC Government requires governance documents. For guidance with writing governance documentation, use the tools available from [Trust-Over-IP](https://trustoverip.org/our-work/deliverables/)
The purpose of this repository is to serve as a registry of groups within the BC Government who are "issuers" of verifiable credentials. Creating an entry in this repository will be a requirement for requesting a digital wallet from the BC Government Digital Trust Services.

## Requirements
The [Wiki](https://github.com/bcgov/bc-vcpedia/wiki) contains detailed instructions on what to include and how to submit for review.

## How to submit your governance documents

email to [EMDT@gov.bc.ca](mailto:EMDT@gov.bc.ca)
By making these resources publicly available, we aim to streamline the adoption process, empowering adopters to become more self-sufficient. While this move towards open access is designed to reduce the need for intensive support from our team, it does not eliminate our advisory support and facilitation when needed. This strategic shift is pivotal for sustainable scaling of digital trust ecosystems.
68 changes: 68 additions & 0 deletions docs/delivery-manual/align.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
title: Align
sidebar_position: 1
---

## Overview
The Align Phase initiates the digital trust adoption journey by creating awareness, identifying potential use cases, and assessing readiness. It establishes a foundation of shared understanding and commitment among participants, setting the stage for successful progression through subsequent phases of discovery, trial, and scaling.
## Key Outcomes

1. **Build Awareness**: Become aware of digital credentials through various channels such as websites, toolkits, or direct outreach. Learn about the potential benefits and applications of digital trust solutions for your organization.

2. **Determine Use Cases**:
Participate in collaborative sessions to brainstorm and evaluate potential use cases for your organization. This process helps select and scope a use case that aligns with your needs and capabilities.

3. **Check Readiness**:
Evaluate if your organization is prepared to move forward to the discovery phase. This assessment considers factors such as resource availability, organizational alignment, and technical readiness.

## Core Activities
Core Activities are key tasks to complete during the Align phase, either independently or with Digital Trust team support, to prepare for adoption.

### Ideation Workshop
==Activity==
An initial workshop focused on brainstorming potential use cases for digital credentials.
🕛 60+ minutes
🙌 Project team
🔨 Miro
💻 Ideation Workshop →

### Ecosystem Workshop
==Activity==
Helps understand and visualize how your digital trust use case fits within an ecosystem.
🕛 60+ minutes
🙌 Project team
🔨 Miro
💻 Ecosystem Workshop →

### Skills and Resource Assessment
==Activity==
An evaluation to determine the necessary skills and resources for the use case.
🕛 60+ minutes
🙌 Project team
🔨 Miro
💻 Skills and Resource Assessment →

### Readiness checklist
==Document==
A tool designed to assess the adopter’s readiness to progress to the next phase.
🕛 45+ minutes
🙌 Project team leads
🔨 Miro
💻 Readiness checklist →

## Considerations

- **Expectation Management:** Ensure clear understanding within your organization about what digital trust can and cannot achieve.

- **Resource Assessment**: Identify potential resource limitations early in the process to avoid surprises later.

- **Scope Definition:** Maintain focus on viable and valuable use cases to prevent project scope from expanding uncontrollably.

- **Internal Alignment:** Ensure key decision-makers and teams within your organization are engaged and supportive from the early stages.


## Additional Resources

- Review the Foundations section of the toolkit: Foundations
- [BC Wallet Showcase](https://digital.gov.bc.ca/digital-trust/showcase/)
- [Contact the Digital Trust Team](mailto:DItrust@gov.bc.ca)
21 changes: 19 additions & 2 deletions docs/delivery-manual/index.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,25 @@
---
title: Delivery Manual
order: 3
sidebar_postion: 3
description: Find step-by-step guidance for successful digital trust adoption.
---

# Delivery Manual
A flexible guide to support adopters through the phases of digital trust adoption.

Test
## Supporting Adoption
The Delivery Manual, designed to facilitate digital trust adoption, includes targeted activities and workshops to guide adopters through various adoption phases while accommodating their unique needs. It serves as a flexible framework, recognizing the specific challenges each adopter may face at different points of their journey.

## The Delivery Process
Structured around four main phases—**Align**, **Discover**, **Trial**, and **Scale**—the Delivery Manual allows for iterative learning and continuous improvement, helping adopters navigate the complexities of digital trust adoption incrementally.

![The image outlines the four phases of the digital trust adoption process—Align, Discover, Trial and Scale—illustrating a non-linear approach for iterative learning and continuous improvement.](/img/deliverymanual/Digital_Trust_Adoption_Phases.png)

1. **Align Phase**: Establish shared goals, connect with stakeholders and identify potential opportunities for the project.
<!-- [Align Phase ->**INTERNAL LINK**](..) -->
hannahgov marked this conversation as resolved.
Show resolved Hide resolved
2. **Discover Phase**: Conduct research, understand needs and create a plan for successful implementation.
<!-- [Discover Phase ->**INTERNAL LINK**](..) -->
3. **Trial Phase**: Develop and test with a select group of users to evaluate performance and gather feedback.
<!-- [Discover Phase ->**INTERNAL LINK**](..) -->
4. **Scale Phase**: Expand to more users, refine the solution and integrate it into existing systems and processes for broader adoption.
<!-- [Discover Phase ->**INTERNAL LINK**](..) -->
111 changes: 111 additions & 0 deletions docs/experience-patterns/Issuance_pattern.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
---
title: Issuance Experience Pattern
sidebar_position: 2
---

## Issuance Overview

The Issuance experience pattern uses digital credentials to securely and efficiently issue verifiable proofs of identity, attributes, or claims. By storing verifiable credentials in a digital wallet, issuers can provide individuals and organizations with trusted and secure digital credentials. This enhances trust and security in digital interactions.

### Issuance Process

Issuing digital credentials typically involves three steps: Authentication, Issue, and Store.

**Authentication:** The individual or organization verifies their identity using the service’s authentication method.

**Issue:** The entity requests the digital credential and the issuer generates and securely sends it to the requester's BC Wallet.

**Store:** The requester stores the digital credential in their BC Wallet for future use in accessing services or proving their identity or attributes.

![an example 3 step issuance process where a person verifies their information prior to being issued the credential and then storing it in their digital wallet](/img/experiencepatterns/issuance-process.png "Example issuance process")

**Technology Required:**

- **BC Wallet:** A secure digital wallet application for storing and managing digital credentials.
- **Digital Credential:** A cryptographically secure and verifiable proof of identity, attributes, or claims.
- **Issuer System:** The system used by the issuer to generate and distribute digital credentials.

### Benefits of issuing digital credentials

**Problem:** Traditional credential methods, like paper documents or centralized databases, are prone to forgery, loss, and breaches. They often lack the security and flexibility needed in the digital age.

**Benefits:** Digital credentials offer a secure, user-friendly method for issuing verifiable credentials. They provide cryptographic assurance, reduce the risk of forgery and data breaches, and streamline the issuance process, improving efficiency and aligning with best practices in digital identity management.

### Suitable use cases

The BC Government and other trusted registries traditionally issue credentials through conventional methods. To future-proof credential issuance, digital trust solutions augment and embed within existing services, providing a secure and flexible approach for the digital age.

**Consider Issuance of Digital Credentials If:**

- **New or Existing Services:** Digital trust benefits both new and existing services, enabling secure credential issuance and extending into signing, accessing, and messaging through the BC Wallet app.
- **Need for Credential Issuance:** If your service requires issuing credentials for identity verification, attributes, or claims, digital trust offers a secure and efficient solution.

Learn more about existing [digital credentials](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/209879044/Digital+Credentials).

### Examples of implementation

Below are examples illustrating the Issuance pattern through a sequence diagram and a real-world case study.

**Sequence Diagram:**

The following sequence diagram visualizes the Issuance pattern using digital credentials. It demonstrates the process of a user (Holder) requesting and receiving a digital credential from an issuer.

![A sequence diagram illustrates a self-serve professional accreditation issuance: Using existing digital credentials to establish a trusted connection, followed by the issuance of the accreditation credential](/img/experiencepatterns/professional-accreditation-pattern.png "Example issuance process")

**Lawyer Use Case:**

A practical implementation of digital trust is showcased in the [justice sector](https://digital.gov.bc.ca/digital-trust/justice-project/). Lawyers get issued a credential from the Law Society of B.C. that proves their practising status (Member credential) and are issued a credential from the BC government (Person credential) which can be used together or separately for a variety of services.

[Watch a video of how lawyers issue their LSBC Member credential](https://www.youtube.com/watch?v=vqATEGCkiU8&list=PLnjj0g-jwI8gmCuVx4rhF7PT397CJXL0p&index=3)

[Watch a video of how people issue their Person crednetial](https://www.youtube.com/watch?v=vqATEGCkiU8&list=PLnjj0g-jwI8gmCuVx4rhF7PT397CJXL0p&index=3)


## Get started

Follow the [Service Delivery Manual](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/203456593) for guidance on activities and workshops that help guide your team **Align**, **Discover**, **Trial** and **Scale**.


### 1. Align

Assess the suitability of digital trust for your service by considering security requirements, user needs, and the potential benefits. Assemble an agile team ready to innovate and experiment.

[Complete the Align phase →](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/204865601)


### 2. Discover

Research user needs and gather insights from stakeholders to understand how digital credentials can enhance user experience and address specific challenges.

[Complete the Discover phase →](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/204832913)

Issuance UX design best practices (TBD)


### 3. Trial

Implement and test the digital trust solution, conducting pilot trials to validate the approach and refine the implementation based on feedback.

[Complete the Trial phase →](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/204865619)

[Becoming an issuer→](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/207126646/Becoming+an+Issuer)


### 4. Scale

Launch the digital trust solution broadly, monitor its performance, and plan for scaling to cover additional services or a broader user base, ensuring continuous improvement.

[Complete the Scale phase →](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/204898449)


## Resources

- Check out the [BC Wallet showcase](https://digital.gov.bc.ca/digital-trust/showcase/) for interactive example
- Review [Becoming an issuer](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/207126646/Becoming+an+Issuer) tutorial
- Explore [existing credentials, their schema and branding](https://bcgov.github.io/aries-oca-bundles/OCABundles/schema/bcgov-digital-trust/LCRB/selling-it-right/)
- [Using Credentials using OpenID4VC Issuer module](https://credo.js.org/guides/tutorials/openid4vc/issuing-credentials-using-openid4vc-issuer-module)
- [Governance Frameworks](https://ditp-bc.atlassian.net/wiki/spaces/DTT/pages/207585320/Governance+Frameworks)

## Contact

If you'd like to start issuing credentials and need support, [connect with the Digital Trust team](https://digital.gov.bc.ca/digital-trust/contact/)
Loading