Skip to content

Commit

Permalink
docs: add storage service test docs (#98)
Browse files Browse the repository at this point in the history
  • Loading branch information
ashleythedeveloper authored Aug 14, 2024
1 parent 06574a1 commit a60bf6e
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@ The Getting Started section covers the following topics for technical interopera
- Setting up storage service testing
- Configuring transparency graph validation tests

**Note**: The preset configuration in the config file (`packages/vc-test-suite/config.ts`) has already been preconfigured to use the services set up with Docker Compose. If you're using the default Docker setup, you may not need to modify these settings.

3. **Usage**: Learn how to run the various components of the technical interoperability test suite and interpret the results. This section will guide you through:
- Running the W3C V2 VCDM tests
- Executing UNTP extension tests
Expand All @@ -27,3 +29,5 @@ The Getting Started section covers the following topics for technical interopera
- Validating transparency graphs

By the end of this section, you will have a solid foundation for installing, configuring, and using the UNTP Technical Interoperability Test Suite. You'll be able to validate your UNTP implementation's technical components against the required standards.

If you're using the default Docker setup, most of the configuration has been done for you. However, if you need to customise any settings or are using a different setup, the configuration section of each component will guide you through the necessary steps.
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,40 @@ import Disclaimer from '../../../\_disclaimer.mdx';

<Disclaimer />

The Storage component testing suite focuses on verifying the security and accessibility of stored credentials and related data.
The Storage component is a critical part of the UNTP ecosystem, responsible for [securely storing and retrieving credentials and related data](https://uncefact.github.io/spec-untp/docs/specification/DecentralisedAccessControl). This test suite verifies the functionality, security, and accessibility of your storage implementation.

Detailed testing procedures and instructions for running the test suite will be provided in future updates. These tests will ensure that your Storage implementation meets the necessary standards for the UNTP ecosystem.
## Testing Instructions

Please check back later for specific testing instructions and requirements.
To test your Storage implementation, follow these steps:

1. **Update the Configuration**:

- Navigate to the config file: `packages/vc-test-suite/config.ts`
- Update the `Storage` section with your implementation details. The file should look similar to this:

```typescript
export default {
implementationName: 'UNTP ACME',
testSuites: {
Storage: {
url: 'http://localhost:3334/v1/documents',
encryptionUrl: 'http://localhost:3334/v1/credentials',
headers: {},
additionalParams: {},
additionalPayload: { bucket: 'verifiable-credentials' },
},
},
};
```

Adjust the `url`, `encryptionUrl`, `headers`, `additionalParams`, and `additionalPayload` as necessary for your implementation.

2. **Run the Test**:

- Navigate to `packages/vc-test-suite`
- In your terminal, run the command: `yarn test`

3. **View Test Results**:
- Navigate to `packages/vc-test-suite/reports/index.html`
- Open this file in a web browser
- Look for the "Storage Service" section to view your test results

0 comments on commit a60bf6e

Please sign in to comment.