docs: update README with integration test instructions

Author: daniellindau

README.md

@@ -1,3 +1,5 @@
+[![Quality](https://img.shields.io/badge/quality-demo-red)](https://curity.io/resources/code-examples/status/)
+
 # Session Revocation Management Plugins
 
 A pair of Curity Identity Server plugins that together enable global SSO session revocation. Packaged as a single JAR containing an Event Listener and an Authentication Action that share a Bucket to track active SSO sessions.
@@ -113,6 +115,36 @@ Deploy to a local Curity server (requires `IDSVR_HOME`):
 ./gradlew deployToLocal
 ```
 
+## Running Integration Tests
+
+Integration tests spin up the Curity Identity Server in a Testcontainers-managed Docker container, deploy the plugin JAR, and exercise the flows end-to-end with a headless browser.
+
+Requirements:
+
+- **Docker** running locally (the test harness pulls the Curity Identity Server image and starts a container)
+- **A valid Curity Identity Server license** (see below for the ways to provide it)
+- **GitHub Packages credentials** (same as for `build`) to resolve the SDK and `curity-ps-sdk-commons` test fixtures
+
+The license key can be supplied in any of the following ways (checked in order):
+
+1. `LICENSE_KEY` environment variable in the shell running Gradle
+2. A `.env` file in the repository root containing `LICENSE_KEY=<your-license-key>` (see [`.env-example`](.env-example)) — convenient for a per-repo setting
+3. `curity.licenseKey` property in `~/.gradle/gradle.properties` — convenient for a global setting shared across Curity plugin repos (same pattern as `gpr.user`/`gpr.token`)
+
+Run all integration tests:
+
+```bash
+./gradlew integrationTest
+```
+
+Run a single spec:
+
+```bash
+./gradlew integrationTest --tests '*.CheckSessionStatusIntegrationSpec'
+```
+
+The configuration applied to the container lives in [`src/test/resources/authentication-config.xml`](src/test/resources/authentication-config.xml) and [`src/test/resources/event-listener-config.xml`](src/test/resources/event-listener-config.xml).
+
 ## License
 
 This plugin is licensed under the [Apache License, Version 2.0](LICENSE).