---
agent_auth:
  skill: https://betonvibrator.com/auth.md
  register_uri: https://betonvibrator.com/api/agent/register
  claim_uri: https://betonvibrator.com/api/agent/claim
  revocation_uri: https://betonvibrator.com/api/agent/revoke
  identity_types_supported:
    - anonymous
    - verified_email
    - identity_assertion
  anonymous:
    credential_types_supported:
      - api_key
      - bearer_token
    claim_uri: https://betonvibrator.com/api/agent/claim
  verified_email:
    credential_types_supported:
      - bearer_token
      - api_key
    claim_uri: https://betonvibrator.com/api/agent/claim
  identity_assertion:
    assertion_types_supported:
      - urn:ietf:params:oauth:token-type:id-jag
      - verified_email
    credential_types_supported:
      - bearer_token
      - api_key
---

# auth.md - Agent Registration for Beton Vibratörü Satış Mağazası | Yay Makina Güvencesiyle

> Autonomous AI agent and bot registration specifications for Beton Vibratörü Satış Mağazası | Yay Makina Güvencesiyle.

This document describes how automated agents can authenticate and interact with Beton Vibratörü Satış Mağazası | Yay Makina Güvencesiyle APIs and storefront resources.

```json
{
  "agent_auth": {
    "skill": "https://betonvibrator.com/auth.md",
    "register_uri": "https://betonvibrator.com/api/agent/register",
    "claim_uri": "https://betonvibrator.com/api/agent/claim",
    "revocation_uri": "https://betonvibrator.com/api/agent/revoke",
    "supported_identity_types": ["anonymous", "verified_email", "identity_assertion"],
    "identity_types_supported": ["anonymous", "verified_email", "identity_assertion"],
    "identity_assertion": {
      "assertion_types_supported": ["urn:ietf:params:oauth:token-type:id-jag", "verified_email"],
      "credential_types_supported": ["bearer_token", "api_key"]
    },
    "anonymous": {
      "credential_types_supported": ["api_key", "bearer_token"],
      "claim_uri": "https://betonvibrator.com/api/agent/claim"
    },
    "verified_email": {
      "credential_types_supported": ["bearer_token", "api_key"],
      "claim_uri": "https://betonvibrator.com/api/agent/claim"
    }
  }
}
```

## Authorization & Discovery Metadata

- **OAuth Authorization Server**: [https://betonvibrator.com/.well-known/oauth-authorization-server](https://betonvibrator.com/.well-known/oauth-authorization-server)
- **OpenID Connect Discovery**: [https://betonvibrator.com/.well-known/openid-configuration](https://betonvibrator.com/.well-known/openid-configuration)
- **OAuth Protected Resource**: [https://betonvibrator.com/.well-known/oauth-protected-resource](https://betonvibrator.com/.well-known/oauth-protected-resource)
- **Key Directory (JWKS)**: [https://betonvibrator.com/.well-known/http-message-signatures-directory](https://betonvibrator.com/.well-known/http-message-signatures-directory)
- **API Catalog**: [https://betonvibrator.com/.well-known/api-catalog](https://betonvibrator.com/.well-known/api-catalog)

## Agent Registration

Agents can register and obtain API credentials via:

- **Register Endpoint**: `https://betonvibrator.com/api/agent/register`
- **Claim Endpoint**: `https://betonvibrator.com/api/agent/claim`

### Supported Identity Types:
1. **Anonymous**: Fast issuance of scoped read-only API access tokens for public catalog queries.
2. **Verified Email**: For agent actions that require account linking or order confirmations.
3. **Identity Assertion (ID-JAG)**: Machine-to-machine JWT bearer assertion via `urn:ietf:params:oauth:token-type:id-jag`.

### Scopes Supported:
- `products`: Query public products, inventory, prices, and categories
- `orders`: Create and query customer orders (requires customer authentication)
- `read`: General read-only data access
- `write`: Cart and checkout submissions

For more details on the Auth.md specification, see [workos.com/auth-md](https://workos.com/auth-md).
