> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HaloPSA

> HaloPSAとの連携方法です。

## サポートする機能

<Info>
  このサービスは基本的なアカウント情報の取得・集計のみに対応しています。
</Info>

## 事前準備

### HaloPSAへのログイン方法

[HaloPSAログインページ](https://ocit.halopsa.com/auth/Account/Login)にて、Usernameまたはメールアドレス、パスワードを入力しログインします。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664781744825.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=2e422347f6151be9a793d3bced8d3c75" alt="HaloPSAログイン画面" width="575" height="582" data-path="images/integrations/4jbf5cz8ap/1664781744825.png" />

### ワークスペースキーの取得方法

**ドメインがワークスペースキー**となります。

https\://**`{ワークスペースキー}`**.halopsa.com/

### Base URIの取得方法

HaloPSAにログイン後、**Configurations > Integrations > HaloPSA API**と進みます。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664785009862.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=cc660dcd0759475b0dacb1258b0767ea" alt="HaloPSA API設定メニュー" width="1261" height="575" data-path="images/integrations/4jbf5cz8ap/1664785009862.png" />

API Detailsに表示されている**Authorisation ServerがBase URL**となるので、保存します。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664785068610.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=37c66c8de82aa41d86dfbfdf3f3018fc" alt="Authorisation Server" width="1055" height="481" data-path="images/integrations/4jbf5cz8ap/1664785068610.png" />

### クライアントIDの取得方法

次に、HaloPSA APIページにて**ApplicationsのView Applictions**をクリックします。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664785552496.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=02988f07f5695f5ce66d4016fe38ace9" alt="Applications一覧" width="428" height="217" data-path="images/integrations/4jbf5cz8ap/1664785552496.png" />

右上の**New**をクリックし、Applicationを作成します。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664785715394.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=f53db1e78fab817562dcfc111aa50ee3" alt="Application作成" width="1479" height="210" data-path="images/integrations/4jbf5cz8ap/1664785715394.png" />

以下の通りに入力します。

Authentication Methodを入力すると、**Client IDが表示されますので**保存します。SAVE後でもClient IDは確認可能です。

**\[Detailsタブ]**

* Application Name：任意の名称を入力します
* Authentication Method：`Authorisation Code (Native Application)`にチェックします。
* Login Redirect URL：`https://itmc.i.moneyforward.com/oauth/callback`を入力します。
* Preferences：`Allow Agent Logins` と `Allow End-User Logins`にチェックします。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664785924001.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=929e09ee80e5331881d5278e53ff98e0" alt="Application Details設定" width="884" height="774" data-path="images/integrations/4jbf5cz8ap/1664785924001.png" />

**\[Securityタブ]**

* CORS Whitelist：`https://itmc.i.moneyforward.com/`　を入力します。

**Save**をクリックします

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664863899670.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=8b4bdc2dbde0a21b9357696b8cd90725" alt="CORS設定" width="1980" height="754" data-path="images/integrations/4jbf5cz8ap/1664863899670.png" />

## インテグレーションのセットアップ

インテグレーション画面にて、**HaloPSA**で検索します。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664787055108.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=13662407a1e7986632d4e7d74c6d0e91" alt="Admina連携画面" width="940" height="484" data-path="images/integrations/4jbf5cz8ap/1664787055108.png" />

前の手順で取得した**Base URI、クライアントID、ワークスペースキー**を入力し、**連携する**をクリックします。

<img src="https://mintcdn.com/moneyforwardi/MhdnE4QAMT1AH6RE/images/integrations/4jbf5cz8ap/1664787136720.png?fit=max&auto=format&n=MhdnE4QAMT1AH6RE&q=85&s=1d75a6e7042c76bf7e22643f80651922" alt="連携情報入力" width="574" height="711" data-path="images/integrations/4jbf5cz8ap/1664787136720.png" />

HaloPSAとの連携に成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。

正常に完了しない場合は、インテグレーション画面のステータスタブから**編集**し、再度連携をお試しください。

解決しない場合はチャットにてお問い合わせください。

HaloPSAの連携概要については[連携ページ](http://admina.moneyforward.com/jp/integrations/halopsa)をご覧ください。
