diff --git a/README.md b/README.md index 8c486b6..1453c00 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,7 @@ requests needed to pass all of the tests. Note that some requests within the col To run the client tests against the Postman collection: 1. Start an Inferno session of the CARIN for Blue Button Client test suite. -3. Click the "Run All Tests" button in the upper right and type in "SAMPLE_TOKEN" for the `access_token` input in the dialog that appears. +3. Click the "Run All Tests" button in the upper right and type in "SAMPLE_TOKEN" for the `Client ID` input in the dialog that appears. 4. Click the "Submit" button. The simulated server will then be waiting for an interaction. 4. Open Postman and import the `C4BB Client Search Tests` Postman collection. 5. Send each of the requests listed under the `C4BB Client Search Tests` Postman collection and ensure a @@ -55,8 +55,7 @@ To run the client tests against the Postman collection: ### CPCDS Reference Implementation Client To try out these tests without a Carin for Blue Button client implementation, you may -run them using the [CPCDS Reference Implementation Client](https://github.com/carin-alliance/cpcds-client-ri). Use this -[forked repository](https://github.com/emichaud998/cpcds-client-ri), which been adjusted to work with this test kit. +run them using the [CPCDS Reference Implementation Client](https://github.com/carin-alliance/cpcds-client-ri). 1. Follow the instructions listed [here](https://github.com/carin-alliance/cpcds-client-ri?tab=readme-ov-file#running-app-locally) to get the CPCDS Reference Implementation Client running locally. @@ -70,9 +69,9 @@ To run the client tests against the CPCDS Reference Implementation Client: 3. Click the "Wait for Claims Data and Search Requests" test group in the left navigation sidebar. 4. Click the "Run Tests" button in the upper right and click the "Submit" button in the dialog that appears. The simulated server will then be waiting for an interaction. -5. Navigate to `localhost:3000`. Enter the Carin Client Suite FHIR endpoint URL, and then type the Carin patient id, `888`, - into the client secret and client id fields. Hit the "Connect" button. -6. On the next page, hit the "Display" button to make a request to the Carin Client Suite . +5. Navigate to `localhost:3000`. Enter the Carin Client Suite FHIR endpoint URL, and then type `SAMPLE_CLIENT_ID` + into the client ID field and `SAMPLE_CLIENT_SECRET` into the client secret field. Hit the "Connect" button. +6. This will connect the client with the test suite via SMART and the client will automatically make a request to the test suite. 7. In the Inferno Client Suite, click the "Click here" link in the wait dialog to signal the client has finished submitting requests. 8. Navigate to each Carin for Blue Button Profile test group in the left navigation sidebar, and for each test group hit the run icon next all the tests listed except for the last required search parameters test diff --git a/config/presets/carin_cpcds_client_ri.json b/config/presets/carin_cpcds_client_ri.json index 001371a..7380060 100644 --- a/config/presets/carin_cpcds_client_ri.json +++ b/config/presets/carin_cpcds_client_ri.json @@ -4,9 +4,9 @@ "test_suite_id": "c4bb_v200_client", "inputs": [ { - "name": "access_token", + "name": "client_id", "type": "text", - "value": "SAMPLE_TOKEN" + "value": "SAMPLE_CLIENT_ID" } ] } diff --git a/lib/carin_for_blue_button_test_kit/docs/carin_for_blue_button_v2.0.0_client_suite_description.md b/lib/carin_for_blue_button_test_kit/docs/carin_for_blue_button_v2.0.0_client_suite_description.md index f24c86c..84a0697 100644 --- a/lib/carin_for_blue_button_test_kit/docs/carin_for_blue_button_v2.0.0_client_suite_description.md +++ b/lib/carin_for_blue_button_test_kit/docs/carin_for_blue_button_v2.0.0_client_suite_description.md @@ -40,7 +40,8 @@ During execution, Inferno will wait for the client under test to issue requests The following input must be provided by the tester to execute any tests in this suite: -1. *Access Token*: A `Bearer` token that the client under test will send in the +1. *Client ID*: A Client ID that the client under test will use to connect to the test suite via SMART. + This client ID will be sent back to the client as the `Bearer` token that the client under test will send in the `Authorization` header of HTTP requests made against Inferno. Inferno uses the value to identify incoming requests that belong to the testing session. @@ -63,7 +64,7 @@ requests needed to pass all of the tests. Note that some requests within the col To run the client tests against the Postman collection: 1. Start an Inferno session of the CARIN for Blue Button Client test suite. -3. Click the "Run All Tests" button in the upper right and type in "SAMPLE_TOKEN" for the `access_token` input in the dialog that appears. +3. Click the "Run All Tests" button in the upper right and type in "SAMPLE_TOKEN" for the `Client ID` input in the dialog that appears. 4. Click the "Submit" button. The simulated server will then be waiting for an interaction. 4. Open Postman and import the `C4BB Client Search Tests` Postman collection. 5. Send each of the requests listed under the `C4BB Client Search Tests` Postman collection and ensure a @@ -78,7 +79,7 @@ to use the same token, they may interfere with each other. To prevent concurrent of these sample executions from disrupting your session it is recommended, but not required, to: 1. Update the Authorization tab of the C4BB Client Search Tests collection in Postman to a random value -2. When starting the tests, provide the same value in the access_token input. +2. When starting the tests, provide the same value in the `Client ID` input. ## Current Limitations @@ -91,3 +92,4 @@ Specific current limitations to highlight include: - Inferno's simulated CARIN server does not support all required search parameters on the ExplanationOfBenefit resource, including service-date, service-start-date, billable-period-start, type, and _include=ExplanationOfBenefit:insurer. Inferno recognizes searches made using those parameters and will give the client credit for having performed them, but will always return an OperationOutcome indicating failure. - Testers must manually configure their client system to connect to a specific target patient and ingest specific curated sample CARIN data. Future versions of the tests may allow more flexibility in the patient identity and the associated data. - Testers must attest to their system's ability to process and retain all received information. Currently, this is implemented as a single test. Future versions of the tests may split this test out into different attestations per profile or other more fine-grained organization. + - This test kit contains basic SMART App Launch capabilities that may not be complete. In particular, refresh tokens are not currently supported and scopes are not precise. To provide feedback and input on the design of this feature and help us prioritize improvements, submit a ticket [here](https://github.com/inferno-framework/carin-for-blue-button-test-kit/issues). \ No newline at end of file