Umami Cloud とセルフホスト版 Umami：iPhone での接続方法をそれぞれ解説

Umami には 2 つの使い方があります。Umami チームが運営する Umami Cloud と、自分のサーバーで動かすセルフホスト版です。どちらも同じ種類の API を提供していて、SiteGlance のようなスマホアプリはこの API からデータを読み込みます。ただし、ログインの方法が異なります。（アプリを初めて使う方は、まず iPhone で Umami を確認する方法をご覧ください。）

Umami Cloud：API キーで接続

Umami Cloud はリクエスト先のアドレスが決まっているため、URL を入力する必要はありません。用意するのは API キーだけです。

1. Umami Cloud のサイドナビゲーションでプロフィールをクリックし、Settings → API keys（設定 → API キー）を開きます。
2. Create key（キーを作成）をクリックして、表示されたキーをコピーします。
3. SiteGlance で接続を追加し、Umami Cloud を選んでキーを貼り付けます。

GET https://api.umami.is/v1/websites
Authorization: Bearer <your-api-key>

セルフホスト：アドレス・ユーザー名・パスワード

自分のインスタンスに接続する場合、SiteGlance はダッシュボードで使っているのと同じユーザー名とパスワードでログインし、セッショントークンを受け取ります。仕組みは Web 画面からのログインとまったく同じです。

• HTTPS のみ対応です。 暗号化されていない http:// のアドレスは受け付けません。インスタンスに証明書がない場合は、先にリバースプロキシを置いて証明書を設定してください。
• Umami が実際に動いているアドレスを入力します。 https://example.com/umami のようにサブパスで公開している場合は、パスまで含めて入力してください。
• アカウントには、見たいサイトの閲覧権限が必要です。

よくある接続エラー

SiteGlance は接続を保存する前に必ず実際に接続を試し、どの段階で失敗したかを表示します。なお、アプリの表示言語は英語と中国語のみで、日本語表示には未対応のため、エラーメッセージも英語で表示されます。主なエラーとその意味は次のとおりです。

• Username or password didn't get a token from the server（ユーザー名またはパスワードでトークンを取得できない）：サーバーがログインを拒否しました。
• Login worked, but this account can't read websites（ログインはできたが、このアカウントにはサイトの閲覧権限がない）：アカウント自体は有効ですが、サイトの情報を読み込めません。
• Host is up, but no Umami API here（ホストには届くが Umami の API が見つからない）：多くの場合、パスの入力漏れか、リバースプロキシが /api を転送していないことが原因です。
• HTTPS certificate isn't valid（HTTPS 証明書が無効）：証明書の期限切れか、自己署名証明書です。
• Can't reach this address（アドレスに接続できない）または Timed out waiting for the server（サーバーの応答がタイムアウト）：ドメインとネットワークを確認してください。
• API key is invalid or revoked（API キーが無効または失効済み）：Umami Cloud で新しいキーを作成してください。

一度接続できれば、Umami Cloud でもセルフホストでもアプリ内の使い勝手は同じです。ホーム画面のウィジェットもどちらでも使えます。