AU Data Holder Testing

This Wych Data Holder Tester (Tester) is the Wych probe for validating the state of a Data Holder solution, this has been designed to support Data Holder testing for ACCC CDR standards with each test verifying a rule as set out in the specifications.

In it’s simplest form you can send request direction with the auth token for the relevant endpoint and their urls.

Alternatively using the Wych Register:

Tester can share a Register and Register Auth instance but has a one-to-one relationship with a Data Holder. The Tester must co-exist with the register as it is responsible for configuring the register and validating the Data Holder to register communications. To accomplish this Tester must have access to the Register and the Registers datastore.

Requirements #

Tester requires a PostgreSQL 14+ relational database. Tester can utilise the same PostgreSQL service as the other non-production service but requires two separate schemas. The schema can be set in the search path to faciliate easy of connection.

The PostgreSQL jdbc syntax is:

jdbc:postgresql://[host]:[port]/[db-name]?currentSchema=[db-schema]

This can be organised as a database per app or a schema per database.

jdbc:postgresql://localhost:5432/testing?currentSchema=au-dataholder-tester
jdbc:postgresql://localhost:5432/au-dataholder-tester?currentSchema=public

Repository #

Tester can be pulled from the following repository. Check Changelog for the latest version.

docker pull wychaustralia.azurecr.io/au-dataholder-tester:[version]

Docker #

For the Tester to start you will need to set the following properties. If you are setting these as environment variables then use the UPPERCASE and replace . (dot) with _ (underscore).

Config #

Compose #

Here is a sample docker compose - this sets up the required DB and configures the Tester service.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

name: au-dataholder-tester
services:
  db:
    image: postgres
    init: true
    environment:
      PGDATA: /var/lib/postgresql/data/pgdata
      POSTGRES_USER: a-database-user
      POSTGRES_PASSWORD: a-database-password
    volumes:
      - au-register-data-volume:/var/lib/postgresql/data/pgdata
    networks:
      au-register-db:
        aliases:
          - au-register-db
  
  #####
  # tester service
  dataholder-tester:
    image: wychaustralia.azurecr.io/au-dataholder-tester:[version]
    depends_on:
      - db
    restart: on-failure
    ports:
      - "80:80"
    environment:
      AUTH_BASE_URL: http://no.op
      WYCH_BASE_URL: http://dataholder-tester
      WYCH_REGISTER_DISCOVERY_URL: http://no.op
      WYCH_REGISTER_RESOURCE_URL: http://no.op

      WYCH_DATASOURCE_JDBC_URL: jdbc:postgresql://db:5432/wych
      WYCH_DATASOURCE_USERNAME: a-database-user
      WYCH_DATASOURCE_PASSWORD: a-database-password

      VERIFY_SSL_CERT: false
networks:
  wych-service:
    name: wych-service
  au-register-auth-db:
      
volumes:
  au-register-auth-data-volume:
      
volumes:
  au-register-data-volume:

Changelog #