# Authentication

This document helps AI agents find **how Shopware-related APIs and accounts authenticate**.
It is hosted on the public marketing site (`www.shopware.com`).

## What this host does not do

- **No OAuth/OIDC issuer** — `www.shopware.com` does not publish `/.well-known/openid-configuration` or access tokens.
- **No auth.md agent registration** — verified-agent and user-claimed registration flows are **not** offered here.
- **No merchant Admin/Store API** — HTTP APIs run on **each customer's Shopware installation** (or cloud URL), not on this domain.

## Machine-readable discovery

| Resource | URL |
| -------- | --- |
| API catalog (RFC 9727) | https://www.shopware.com/.well-known/api-catalog |
| Agent resource catalog (ARD) | https://www.shopware.com/.well-known/ai-catalog.json |
| Security contact | https://www.shopware.com/.well-known/security.txt |

## Shopware Admin API (per installation)

Administrative REST API for a single shop instance. Credentials (integration, OAuth app, etc.) are created **in that shop's Admin**.

- Documentation: https://developer.shopware.com/docs/concepts/api/admin-api.html
- OpenAPI (reference): https://raw.githubusercontent.com/shopware/admin-api-reference/main/adminapi.json
- Interactive reference: https://shopware.stoplight.io/docs/admin-api

## Shopware Store API (per installation)

Storefront-oriented API bound to a sales channel on a shop instance.

- Documentation: https://developer.shopware.com/docs/concepts/api/store-api.html
- OpenAPI (reference): https://raw.githubusercontent.com/shopware/store-api-reference/main/storeapi.json
- Interactive reference: https://shopware.stoplight.io/docs/store-api

## Shopware Account (merchant services)

Human sign-in for subscriptions, licensing, and cloud account management:

- https://account.shopware.com/

Programmatic OAuth discovery for agents may live on product-specific hosts; it is **not** asserted on `www.shopware.com`.

## Further reading

- Developer Portal: https://developer.shopware.com/
- End-user documentation: https://docs.shopware.com/
- Community Hub (news, discussions, release information): https://hub.shopware.com/
- Extension Store: https://store.shopware.com/

## Reporting security issues

See `https://www.shopware.com/.well-known/security.txt` (contact: alert@shopware.com).