Repository navigation
Releases
v0.1.2
Added
- Signed releases (workflow
release.yml): each GitHub release carries the distribution archive, itsSHA256SUMS
and a SLSA build provenance attestation (*.intoto.jsonl, Sigstore); see Verifying a release in SECURITY.md. - CodeQL analysis of the GitHub Actions workflows (workflow
codeql.yml) on every pull request and push tomain.
Changed
composer.jsonhomepagenow points to the project page, shown by Packagist:
https://the-bearded-bear.com/open-source/urssaf-attestations-verification-code-securite. The README links to it
and to the overview of the URSSAF packages.
v0.1.1
Added
- Benchmarks (
tests/Benchmark,make bench, PHPBench isolated intools/phpbench): validation of a full batch of
security codes, encoding of a full verification request, decoding of the official responses; the CI jobbenchmark
compares each pull request with its base commit and fails above a 20 % regression. - Published quality proofs: Codecov (coverage), Stryker Dashboard (mutation report of
main), SonarQube Cloud (job
sonarcloud) and OpenSSF Scorecard (workflowscorecard.yml), with their badges in the README.
Changed
-
CI: every GitHub Action is pinned to a commit SHA, kept up to date by Dependabot (
.github/dependabot.yml, also
for Composer). -
Dockerfile linted by hadolint (
make hadolint, part ofmake ci, CI jobhadolint); the development image runs as
a non-root user by default. -
CI: GitHub Actions updated to their latest major versions (Dependabot).
-
SonarQube Cloud coverage measured on the package code only (
sonar.coverage.exclusions); live proof badges in
the README (Codecov, Stryker mutation score, SonarQube Cloud, OpenSSF Scorecard). -
README: maintainer (The Bearded Bear), the other URSSAF packages and professional support; composer
authorsnow points to https://the-bearded-bear.com. -
The Symfony Flex recipe is published on the public
symfony/recipes-contribrepository (ADR 0009, superseding
ADR 0008): enable contrib recipes withcomposer config extra.symfony.allow-contrib true.
Removed
- The private Flex endpoint generator
bin/build-flex-endpoint, the CI jobflex-endpointand thesymfony/process
development dependency.
v0.1.0
Added
- Project skeleton: Docker tooling, quality gates (
make ci) and GitHub Actions CI, identical to the other URSSAF
packages. - Specification: official OpenAPI contracts (
docs/openapi/), official documentation (links indocs/api-reference.md, local copy in the git-ignoreddocs/reference/), technical
reference (docs/api-reference.md) and implementation roadmap (docs/roadmap.md). - Architecture decision records (
docs/adr/): reference architecture inherited fromurssaf-tiers-prestations
(0000), stateless SDK, verification result model, batching, quotas and retry,domaineparameter, error codes. - Domain model:
SecurityCode, certificate natures (§3.1), per-code fault codes (FUNC201–FUNC203), verification
result sum type (VerifiedCertificate|RejectedCode) and one value object per nature-specific data key (AMP, AVG,
CSG, CFP, EPM, FRS, CAAE, ASAA). - Wire mappers for the verification response (
DD/MM/YYYYissue date, nature-specific keys, per-code faults) and the
multiple-verification request; request-level error payload parser (FUNC013,FUNC015,FUNC016,ERR_TECHNIQUE). - HTTP gateway
UrssafHttpGateway(built byUrssafGatewayFactory): OAuth2 client credentials with a pluggable PSR-6,
PSR-16 or in-memory token store, GET single verification (configurabledomaine, defaultURSSAF), POST multiple
verification (1–100 codes), error mapping (UrssafRequestRejected,UrssafAuthenticationFailed, retryable
UrssafUnavailablewithRetry-Afteron 429/500/503). - Application queries
VerifyCertificateandVerifyCertificates(chunked by 100, input order preserved, an empty input makes no call). - Framework-free entry point
Standalone\UrssafAttestationsVerificationBuilder(docs/standalone.md). - In-memory
Testing\SimulatedCertificateVerificationGatewayfor host applications' tests (docs/testing.md). - Symfony bundle
UrssafAttestationsVerificationCodeSecuriteBundle(urssaf_attestations_verification_code_securite): configuration (environment, base URI,domain, credentials per tenant or provider, token cache pool, simulated gateway), public query handlers, commandsurssaf:certificate:verifyandurssaf:check, translations (en, fr) of the violation codes (docs/symfony.md). - Opt-in contract tests against the URSSAF sandbox (
make test-contract, manual CI jobcontract), first target: confirm whetherdomainecan be omitted. - Symfony Flex recipe (
recipe/): registers the bundle, copies a commented configuration (simulated gateway in the test environment) and adds theURSSAF_*variables to.env;bin/build-flex-endpointbuilds a private Flex endpoint, published by the CI jobflex-endpoint(ADR 0008).
Changed
- The package is open source under the MIT license (previously proprietary). Added
CONTRIBUTING.mdand
SECURITY.md, and a notice in the README stating that the package is unofficial and not affiliated with URSSAF. - The official URSSAF documents are no longer versioned:
docs/reference/is a local, git-ignored folder.