> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API 認証

> GOWAはAPI呼び出しをHTTPベーシック認証のみで認証します。

GOWA は **HTTP Basic Auth** をサポートしています。API キー、所有者トークン、REST API の JWT は存在しません。 (MCP は OAuth トークンを追加で受け入れることができます。[MCP サーバ](https://gowa-docs.mintlify.site/ja/integrations/mcp.md#oauth-%E3%82%92%E6%8C%81%E3%81%A4%E3%83%AA%E3%83%A2%E3%83%BC%E3%83%88%E3%82%AF%E3%83%A9%E3%82%A4%E3%82%A2%E3%83%B3%E3%83%88) を参照してください。

## 設定

```bash theme={null}
APP_BASIC_AUTH=admin:changeme,ops:another-password   # or --basic-auth=admin:changeme
```

カンマで区切られた `user:pass`ペアは有効なログインです。すべてのエントリにはユーザー名とパスワードの両方が必要です。 非ループバックリスナーは、完全な資格情報なしで開始することを拒否します。 `APP_HOST=127.0.0.1` を認証されていないローカル開発にバインドします。リバースプロキシが発信者を認証し、GOWAへの直接アクセスが制限されている場合にのみ、 `APP_ALLOW_UNAUTHENTICATED=true` を使用してください。

## 資格情報を送信

```bash curl theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```bash Header theme={null}
curl -H "Authorization: Basic $(echo -n 'admin:changeme' | base64)" \
  -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```javascript JavaScript theme={null}
const res = await fetch("http://localhost:3000/user/my/groups", {
  headers: {
    Authorization: "Basic " + Buffer.from("admin:changeme").toString("base64"),
    "X-Device-Id": "my-device",
  },
});
```

```python Python theme={null}
import requests
r = requests.get("http://localhost:3000/user/my/groups",
                 auth=("admin", "changeme"),
                 headers={"X-Device-Id": "my-device"})
```

認証情報が間違っているか不足している場合は、 `401 Unauthorized` を返します。

## 公共ルート

| ルート | なぜ |
| - | - |
| `/health` | ライブ性チェック。 |
| `/statics/*` | 既知の URL は公開されたままです。画像以外のアップロードは添付ファイルとしてダウンロードされます。必要に応じてプロキシでアクセスを保護してください。 |
| `/chatwoot/webhook`, `/chatwoot/webhook/{device_id}` | Chatwoot; `CHATWOOT_WEBHOOK_SECRET` によって保護されています。 |
| MCP OAuthエンドポイントと `/.well-known/*` メタデータ | 有効な場合のOAuthフロー。 |

## WebSocket

ブラウザはWebSocket接続でヘッダを設定できないため、`/ws`は`/ws?device_id=my-device&authorization=<base64 user:pass>`を受け付けます。`wss://`を使用してプロキシログからのredactクレデンシャルを使用してください。

WebSocketと状態を変更するHTTPルートは、信頼できないブラウザの起源を拒否します。`APP_TRUSTED_ORIGINS` または `APP_CORS_ALLOWED_ORIGINS` でダッシュボードの正確な起点を設定します。 CORS のワイルドカードはこのアクセスを許可しません。`file://`からの`null`オリジンは拒否されます。 信頼できないオリジンからの HTTP 変更は `403 CROSS_SITE_REQUEST_BLOCKED` を返します。[ブラウザのアクセス設定](https://gowa-docs.mintlify.site/ja/authentication.md#cors) を参照してください。

## デバイスヘッダー

Basic AuthはWhatsAppアカウントではなく、API呼び出し元を識別します。 複数のデバイスが存在する場合、すべてのデバイススコープの呼び出しには `X-Device-Id` が必要です。 [Multi-device](https://gowa-docs.mintlify.site/ja/concepts/multidevice.md) を参照してください。

> [!WARNING]
>
> Basic 認証は、すべてのリクエストに対して資格情報を送信します。信頼できるネットワーク外の GOWA の前で HTTPS を使用します。


## Related topics

- [認証](https://gowa-docs.mintlify.site/ja/authentication.md)
- [APIリファレンス](https://gowa-docs.mintlify.site/ja/api-reference/introduction.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/ja/index.md)
- [クイックスタート](https://gowa-docs.mintlify.site/ja/quickstart.md)
- [サーバーメトリック](https://gowa-docs.mintlify.site/ja/api-reference/metrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.