Skip to content

codeforamerica/sebt-self-service-portal-co-connector

Repository files navigation

sebt-self-service-portal-co-connector

A repository containing the implementation for the Colorado backend connector.

CI

The GitHub Actions workflow (.github/workflows/ci.yml) builds and tests the connector on every push and PR to main.

Required credentials

The CI workflow uses GITHUB_TOKEN (provided automatically) to check out the state-connector repo for the interface package. No additional secrets are required for CI to pass — all tests that need external credentials skip gracefully when they are not configured.

Optional: CBMS sandbox integration tests

CI runs CBMS integration tests with mock responses by default, so no secrets are required for the build to pass (sandbox health checks that require the real API are skipped). To exercise the real sandbox in CI, add these as GitHub Actions repository secrets and set Cbms__UseMockResponses=false in the workflow:

Secret Description
CBMS_CLIENT_ID OAuth client ID for the CBMS environment
CBMS_CLIENT_SECRET OAuth client secret for the CBMS environment

For local development, use .NET user secrets instead:

cd src/SEBT.Portal.StatePlugins.CO.Tests
dotnet user-secrets set "Cbms:ClientId" "<id>"
dotnet user-secrets set "Cbms:ClientSecret" "<secret>"

Optional: Run integration tests with mock responses

To run the CBMS integration tests without real credentials or network access, enable mock responses:

cd src/SEBT.Portal.StatePlugins.CO.Tests
dotnet user-secrets set "Cbms:UseMockResponses" "true"

Or use an environment variable: Cbms__UseMockResponses=true

Local development with mock responses

The same mock responses used in integration tests are available when running the host application. Set Cbms:UseMockResponses=true in your host's configuration or Cbms__UseMockResponses=true as an environment variable. The Colorado plugin will use mock CBMS API responses (you don't need the client_id/secrets for this to work).

Mock response data lives in src/SEBT.Portal.StatePlugins.CO.CbmsApi/TestData/CbmsMocks/ as JSON files. Edit those files to change mock scenarios without recompiling.

About

Colorado backend connector for the Summer EBT Portal

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages