> For the complete documentation index, see [llms.txt](https://docs-embed.anyflow.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-embed.anyflow.jp/release/wizard-hosting.md).

# Anyflowドメインでの提供

## 概要

自社プロダクトにAnyflowを組み込むのではなく、Anyflowが取得したドメイン上でソリューションを提供する方法について紹介します。（例：<https://anyflow-demo.integrations.jp/>）

<figure><img src="/files/jKPhYXV9F4Uvg5q1fotC" alt=""><figcaption></figcaption></figure>

これを**ウィザードホスティング機能**と呼びます。

※ウィザード を、Anyflowシステムによってホスティング（貸し出し）する機能です。

{% hint style="success" %}
この機能を利用する場合はAnyflow CSチームにご連絡ください。\
Anyflow Embedの管理画面からウィザードホスティングを発行することはできません。
{% endhint %}

## ユースケース/解決する課題

* 連携ソリューションの仮説検証フェーズのため、プロダクトチームの工数を使わずに限られたエンドユーザーに連携ソリューションを提供したい
* Anyflow SDKを組み込むための開発工数が取れない/時間がかかる

## メリット

* ベンダープロダクトでAnyflow SDKを使ってウィザードを表示するための開発工数がゼロになります。
* メールやコミュニケーションツール（Slack, Teams）などで、エンドユーザーにウィザードホスティングのURLを送付することで、限られたエンドユーザーに連携ソリューションを提供できるようになります。

## デメリット

* ウィザードホスティングは、Anyflow社が管轄するドメイン（integrations.jp）で動作するため、エンドユーザーはベンダープロダクトから離脱して連携ソリューションを設定する必要があります。
* 現時点では、ウィザードホスティングにソリューションをデプロイするにはAnyflow CSチームでの設定が必要になります。

***

## ウィザードホスティングでデプロイ環境を使う方法

ウィザードホスティングのURLにenvパラメータを付与してアクセスすることで、デプロイ環境を切り替えることができます。

URLの形式：[https://xxx.integrations.jp?env={デプロイ環境のユニーク名}](https://xxx.integrations.jp/?env=%7B%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4%E7%92%B0%E5%A2%83%E3%81%AE%E3%83%A6%E3%83%8B%E3%83%BC%E3%82%AF%E5%90%8D%7D)

例：[https://sample.integrations.jp](https://sample.integrations.jp/) の場合

* デフォルトの環境：[https://sample.integrations.jp](https://sample.integrations.jp/)
* ローカル環境：[https://sample.integrations.jp?env=local](https://sample.integrations.jp/?env=local)
* ステージング環境：[https://sample.integrations.jp?env=staging](https://sample.integrations.jp/?env=staging)

{% hint style="warning" %}
envパラメータを使ったアクセスは開発者内にとどめ、\
エンドユーザーに対してはenvパラメータがないURL(デフォルトの環境)を提供することを推奨しております。
{% endhint %}

***

## 参考情報

### ウィザードホスティングの全体図

<figure><img src="https://files.readme.io/0518ef7-wizard-hosting-overall-view.jpg" alt="" width="563"><figcaption></figcaption></figure>

### ログインの仕組み

ウィザードホスティングには、API Keyを入力し、認証するケースと、OAuth2で認証するケースの二通りが存在します。\
エンドユーザーは、ウィザードホスティングにアクセスし、連携ソリューションの設定を試みようとするとサインインする画面が表示されます。

以下のスクリーンショットの例は、API Keyを入力するケースのサインインページです。

<figure><img src="https://files.readme.io/53b9a96-wizardhosting_signin.png" alt="2880"><figcaption><p>API Keyのサインイン画面</p></figcaption></figure>

サインインページでは、ウィザードホスティングシステムがベンダープロダクトのAPIをコールし、エンドユーザーの認証が行われます。\
入力されたAPIキーで、APIが正常に呼び出せた場合にサインインする仕様です。

#### API Keyパターン

<figure><img src="https://files.readme.io/7a7f79f-wizard-hosting-api-key-ver.jpg" alt="" width="563"><figcaption></figcaption></figure>

#### OAuth2パターン

<figure><img src="https://files.readme.io/77867a6-wizard-hosting-oauth2-ver.jpg" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs-embed.anyflow.jp/release/wizard-hosting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.