← Report card

Verify the job: Resolve a name

Run the job against Cloudflare 1.1.1.1 Public DNS with your own account, on your own GitHub Actions runner, and the report card shows it verified. Sourcey never holds your credentials, and a run never changes the grade.

Set it up

  1. Save this as .github/workflows/sourcey-agent-readiness-835381d4b74e9898bf64d07201ec0b74cade55d0a42c3358ebdbaa69fc4314f5.yml on your repository's default branch:

    name: "Agent Readiness: Cloudflare 1.1.1.1 Public DNS / Resolve a name"
    
    on:
      schedule:
        - cron: "19 20 27 * *"
      workflow_dispatch:
    
    jobs:
      verify:
        permissions:
          id-token: write
        uses: sourcey/agent-readiness-action/.github/workflows/run.yml@727b296c203d555a699db1ca8466a874611d9d52 # v1.0.6
        with:
          profile: arp_01m4pmsqywp6qy5atxtaz1phm8
          binding: doh-json
        secrets:
          credentials: ${{ secrets.SOURCEY_AGENT_READINESS_835381D4B74E9898BF64D07201EC0B74CADE55D0A42C3358EBDBAA69FC4314F5 }}
  2. In Settings → Secrets and variables → Actions, add the repository secret SOURCEY_AGENT_READINESS_835381D4B74E9898BF64D07201EC0B74CADE55D0A42C3358EBDBAA69FC4314F5. This binding needs no credentials, so its value is just:

    {}
  3. Open Actions → Agent Readiness: Cloudflare 1.1.1.1 Public DNS / Resolve a name → Run workflow to check the job now. After that it runs once a month on its own, at the day and time in the workflow (UTC), which is this job's own so runs spread out.

The card shows the job verified with the date of the last run that did it. When a run doesn't do the job, the workflow fails, so GitHub tells you, and the run's summary says what failed.

The workflow pins the Action's v1.0.6 release by its full commit. Sourcey accepts runs only from releases it tagged, and only on GitHub-hosted runners. GitHub stops the scheduled runs of a public repository that has gone 60 days without a commit, so use one that sees commits, such as your SDK's.

Say the runs are yours

A run from any repository can verify the job. Your own runs count for more: two of them, a while apart, that fail the same way put that failure on the card in place of Job verified until one of yours passes. To make a repository's runs yours, add a DNS TXT record on cloudflare.com:

_sourcey-agent-readiness.cloudflare.com  TXT  "github-owner-id=<owner id> github-repository-id=<repository id>"

This prints the value for a repository:

gh api repos/OWNER/REPO --jq '"github-owner-id=\(.owner.id) github-repository-id=\(.id)"'

What leaves your runner

  • Your credentials never do. They're held in memory for the run and sent only to the binding's own endpoints.
  • If a response echoes a credential back, it isn't kept: the run stops there and proves nothing either way. So does a service that answers 429 or 5xx.
  • Sourcey receives a record of each request, the response bodies with credentials removed, and a signed attestation of the record. It publishes the record, never your repository's name, and keeps the bodies and the attestation private.

The Action's README