Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
9977e66
Add Bootstrap script to store a credential in the vc-auth agent
Gavinok Nov 25, 2025
e95925b
Merge branch 'main' into bootstrap-credential
Gavinok Nov 26, 2025
9d05697
Initial setup for testing and logging verifying vc-auth
Gavinok Nov 27, 2025
a7ac158
Merge branch 'main' into bootstrap-credential
Gavinok Dec 2, 2025
a9e2ca0
Static Schema Name In Bootstrap
Gavinok Dec 2, 2025
1749d00
Split Issuer into a seperate docker compose file
Gavinok Dec 2, 2025
246e5f4
Merge branch 'bootstrap-credential' into logging-for-prover-role
Gavinok Dec 2, 2025
d67ea9f
update changes to work with separate compose approach
Gavinok Dec 2, 2025
2b9f4d5
Schema is still dynamic but now with a static starting string
Gavinok Dec 2, 2025
784433b
Merge branch 'bootstrap-credential' into logging-for-prover-role
Gavinok Dec 2, 2025
bd00880
Added prover role logging tests
Gavinok Dec 2, 2025
874cbb5
Merge remote-tracking branch 'origin/main' into logging-for-prover-role
Gavinok Dec 18, 2025
c02e0c1
Add documentation for prover role
Gavinok Jan 8, 2026
b5938a1
Merge branch 'main' into logging-for-prover-role
esune Jan 12, 2026
f4c115c
Enhance mutual authentication flow and Docker configuration
Gavinok Jan 13, 2026
2e84d1b
Enhance webhook handling for presentation records
Gavinok Jan 14, 2026
adf3f61
Update Docker configuration and enhance cleanup verification
Gavinok Jan 15, 2026
1a6ce83
Merge branch 'main' into logging-for-prover-role
Gavinok Jan 15, 2026
6d2831a
Merge branch 'main' into logging-for-prover-role
esune Jan 22, 2026
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
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ Make sure to read the [best practices](/docs/BestPractices.md) to be used when p

If you are upgrading from a previous release, take a look at the [migration guide](/docs/MigrationGuide.md).

For information about prover-role functionality (when VC-AuthN responds to proof requests), see the [prover role logging documentation](/docs/ProverRoleLogging.md).

## Pre-requisites

- A bash-compatible shell such as [Git Bash](https://git-scm.com/downloads)
Expand Down Expand Up @@ -105,6 +107,23 @@ curl -X 'POST' \

After all these steps have been completed, you should be able to authenticate with the demo application using the "Verified Credential Access" option.

## Advanced Features

### Prover Role (Trusted Verifier Credentials)

VC-AuthN can also act as a **prover**, holding credentials in its own wallet and responding to proof requests from external verifiers. This is useful for trusted verifier networks where VC-AuthN must prove its authorization status.

For detailed information about prover-role functionality, testing, and configuration, see the [Prover Role Logging documentation](docs/ProverRoleLogging.md).

**Quick Test**: To test prover-role functionality with the bootstrap script:
```bash
cd docker
TEST_PROVER_ROLE=true \
LEDGER_URL=http://test.bcovrin.vonx.io \
TAILS_SERVER_URL=https://tails-test.vonx.io \
./manage bootstrap
```

## Debugging

To connect a debugger to the `vc-authn` controller service, start the project using `DEBUGGER=true ./manage single-pod` and then launch the debugger.
Expand Down
1 change: 1 addition & 0 deletions docker/docker-compose.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,7 @@ services:
- ACAPY_AUTO_VERIFY_PRESENTATION=true
- ACAPY_AUTO_RESPOND_CREDENTIAL_OFFER=true
- ACAPY_AUTO_STORE_CREDENTIAL=true
- ACAPY_AUTO_RESPOND_PRESENTATION_REQUEST=true
- ACAPY_WALLET_STORAGE_TYPE=${WALLET_TYPE}
- ACAPY_READ_ONLY_LEDGER=true
- ACAPY_GENESIS_TRANSACTIONS_LIST=/tmp/ledgers.yaml
Expand Down
4 changes: 2 additions & 2 deletions docker/manage
Original file line number Diff line number Diff line change
Expand Up @@ -197,13 +197,13 @@ configureEnvironment() {
# This must be called AFTER setNgrokEndpoints to ensure URLs are properly set
finalizeEnvironment() {
# Controller Webhook URL: Append API Key if present
if [ ! -z "${CONTROLLER_API_KEY}" ] && [[ "${CONTROLLER_WEB_HOOK_URL}" != *"#"* ]]; then
if [ -v CONTROLLER_API_KEY ] && [ -n "${CONTROLLER_API_KEY}" ] && [[ "${CONTROLLER_WEB_HOOK_URL}" != *"#"* ]]; then
export CONTROLLER_WEB_HOOK_URL="${CONTROLLER_WEB_HOOK_URL}#${CONTROLLER_API_KEY}"
fi

# Agent Admin Mode: Append API Key if present
export AGENT_ADMIN_MODE="admin-insecure-mode"
if [ ! -z "${AGENT_ADMIN_API_KEY}" ]; then
if [ -v AGENT_ADMIN_API_KEY ] && [ -n "${AGENT_ADMIN_API_KEY}" ]; then
export AGENT_ADMIN_MODE="admin-api-key ${AGENT_ADMIN_API_KEY}"
fi

Expand Down
Loading