> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Jamf（Pro）

> JAMFとの連携の手順です。

## サポートする機能

<Badge color="blue">アカウント削除</Badge> <Badge color="blue">アカウント作成</Badge> <Badge color="blue">デバイス集計</Badge>

## 事前準備（Jamf Pro）

### APIロールの作成

Jamf Proで API クライアントに権限を付与するには、まず権限セットを定義するAPIロールを作成します。APIロールを1 つ以上をクライアントに割り当てて権限を付与できます。

詳細は[API Roles and Clients（外部サイト）](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#)もご参照ください。

1. Jamf Proのサイドバーで**設定** をクリックします。

2. **システム**セクションの**APIロールとクライアント**をクリックします。

3. ペイン上部にある**API ロール**タブをクリックします。

4. **新規**をクリックします。

5. API ロールの表示名を入力します。任意の名前を入力します。

6. 権限セットを入力します。次の権限をセットしてください。

   * `Read Accounts`
   * `Delete Accounts`
   * `Create Accounts`
   * （`Jamf Pro User Accounts & Groups(Read）`）

   MDM連携を実施する場合、上記に加えて、以下の権限を併せてセットしてください。

   * `Read Buildings`
   * `Read Departments`
   * `Read Mobile Devices`
   * `Read Computers`
   * `Read Sites`

7. **保存** をクリックします。

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1705977846842-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=7842542ab66db2465fa8fc09cf3f3d1a" alt="APIロール作成画面" width="3328" height="1050" data-path="images/integrations/a9ybjwczho/1705977846842-image.png" />

### APIクライアントの作成

1. Jamf Proのサイドバーで**設定** をクリックします。
2. システムセクションのAPIロールとクライアントをクリックします。
3. ペイン上部にあるAPlクライアントタブをクリックします。
4. **新規**をクリックします。
5. APlクライアントの表示名を入力します。
6. **APIロール**フィールドで、作成した**APIロール**を追加します。

<Info>
  後でアクセストークンの有効期間の値を変更しても、API クライアントから以前に生成されたアクセストークンには影響しません。同様に、クライアントを削除または無効にしても、以前に生成されまだ有効なアクセストークンへのアクセスは不許可になりません。長めの値を設定すること推奨します。ただし、クライアントに割り当てられた API ロールに変更を加えると、すべてのアクセストークンに直ちに影響します。
</Info>

7. クライアントシークレットを生成するには、**APIクライアントを有効にする**をクリックします。
8. **保存**をクリックします。

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1705978446933-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=6ecb14ff25ab33beb1d5674306f909c9" alt="APIクライアント作成画面" width="3330" height="1898" data-path="images/integrations/a9ybjwczho/1705978446933-image.png" />

### クライアントシークレットの作成

1. Jamf Proでアクセストークンの生成元となるAPIクライアントに移動します。

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1705978542471-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=17b59b382a4eb6464c901a1f0d4cb189" alt="APIクライアント選択画面" width="2988" height="1254" data-path="images/integrations/a9ybjwczho/1705978542471-image.png" />

2. **クライアントシークレットを生成**をクリックします。確認ダイアログが表示されます。
3. シークレットを作成をクリックします。ポップアップウィンドウに**クライアントID**および、**クライアントシークレット**が表示されますので保存します。

<Info>
  クライアントシークレットが表示されるのは 1 回のみです。ダイアログを閉じる前に、必ず安全な場所に保存してください。
</Info>

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1705978657502-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=95e658244d15cd7379cab67e8cd0b20f" alt="クライアントシークレット生成画面" width="1180" height="830" data-path="images/integrations/a9ybjwczho/1705978657502-image.png" />

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

Jamfにログイン後、**URLの一部分がワークスペースキー**となるので、保存します。

http\://**`{ワークスペースキー}`**.jamfcloud.com

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1648104137970-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=5264e4f80ddd9905377c27058bb5a3b9" alt="Jamf URL例" width="1070" height="520" data-path="images/integrations/a9ybjwczho/1648104137970-image.png" />

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

1. Adminaのインテグレーション > インテグレーションで**Jamf**と検索します。

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1718006155781-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=bd290f4e45c5d5bb607764cc63a7c07f" alt="Jamf検索画面" width="942" height="497" data-path="images/integrations/a9ybjwczho/1718006155781-image.png" />

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

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1718005971800-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=626d5f3c3e86a7685f0394ff68452fbc" alt="Jamf連携設定画面" width="479" height="836" data-path="images/integrations/a9ybjwczho/1718005971800-image.png" />

3. MDM連携する場合、`取得データの種類：デバイス`にチェックを入れ、**連携する**をクリックします。

デバイスグループフィルタに**Jamfのサイト名**を入力するとサイトに属するデバイスのみが取得されます。

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1718006598340-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=e21b406752b494de8b7a864edf3f3291" alt="MDM連携設定画面" width="456" height="821" data-path="images/integrations/a9ybjwczho/1718006598340-image.png" />

<img src="https://mintcdn.com/admina-sbn/RbsSHdkTH_CYcuXj/images/integrations/a9ybjwczho/1718006371393-image.png?fit=max&auto=format&n=RbsSHdkTH_CYcuXj&q=85&s=4c078b1467a8133e10c6a7a6ee140962" alt="デバイスグループフィルタ設定" width="2093" height="943" data-path="images/integrations/a9ybjwczho/1718006371393-image.png" />

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

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

解決しない場合は詳細を記載の上、チャットでお問い合わせください。Jamfの連携概要は[連携ページ](http://admina.moneyforward.com/jp/integrations/jamf)をご覧ください。

## MDM連携

[4-0.MDM連携に対応SaaSとAdminaデバイス台帳を連携する](/it-management/device/k1u975zc6h-mdm)
デバイス管理機能をご利用の場合、Jamfとのデバイス同期が可能です。詳細はMDM連携に対応SaaSとAdminaデバイス台帳を連携するをご覧ください。

### 同期対象項目

| Admina側の項目     | 同期パターン       | Jamf側 (computer)                 | Jamf側 (phone)          | 補足事項                                                                                                                                          |
| -------------- | ------------ | -------------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| 資産番号           | (2)Adminaベース | `<mdmname>_<hostname>`           | `<mdmname>_<hostname>` | 重複した場合はプレフィックスがつきます。                                                                                                                          |
| モデル名           | (2)Adminaベース | ハードウェア > モデル                     | ハードウェア > モデル           |                                                                                                                                               |
| シリアルナンバー(IMEI) | (1)MDMベース    | ハードウェア > シリアル番号                  | ハードウェア > シリアル番号        | マージキーです                                                                                                                                       |
| Email          | (2)Adminaベース | ユーザと位置 > Ｅメールアドレス                | ユーザと位置 > Ｅメールアドレス      | Adminaのディレクトリに存在しないメールアドレスでも、ディレクトリとデバイスの紐付けは実行されます。その際にディレクトリの項目にもメールアドレスが追加されます。                                                            |
| 種別             | (2)Adminaベース | ハードウェア > モデル識別子                  | ハードウェア > モデル識別子        | iMacはデスクトップPC、それ以外はラップトップPC、PhoneはPhone                                                                                                       |
| ステータス          | (2)Adminaベース | ユーザと位置 > Ｅメールアドレス から判断           | ユーザと位置 > Ｅメールアドレス から判断 | Jamf側にメールアドレスが登録されている場合は「利用」に、それ以外は「在庫」に。                                                                                                     |
| 電話番号           | (1)MDMベース    | -                                | ネットワーク > 電話番号          |                                                                                                                                               |
| ロケーション1        | (2)Adminaベース | ユーザと位置 > 建物                      | ユーザと位置 > 建物            |                                                                                                                                               |
| ロケーション2        | (2)Adminaベース | ユーザと位置 > 部署                      | ユーザと位置 > 部署            |                                                                                                                                               |
| 購入日            | (2)Adminaベース | 購入 > 購入日                         | 購入 > 購入日               |                                                                                                                                               |
| 製造元            | (1)MDMベース    | ハードウェア > Make                    | "Apple"                |                                                                                                                                               |
| 型番             | (1)MDMベース    | -                                | ハードウェア > モデル番号         |                                                                                                                                               |
| CPU            | (1)MDMベース    | ハードウェア > プロセッサタイプ                | -                      |                                                                                                                                               |
| メモリ            | (1)MDMベース    | ハードウェア > メモリの総容量                 | -                      |                                                                                                                                               |
| HDD/SSD        | (1)MDMベース    | 容量 > ドライブ容量                      | -                      |                                                                                                                                               |
| OS             | (1)MDMベース    | オペレーティングシステム > オペレーティングシステム      | デバイスタイプ                |                                                                                                                                               |
| バージョン          | (1)MDMベース    | オペレーティングシステム > オペレーティングシステムバージョン | 一般 > iOS バージョン         |                                                                                                                                               |
| キーボード配列        | (1)MDMベース    | 一般もしくはハードウェア > 拡張属性              | -                      | 項目名：テキストフィールドより、項目名にKeyboardもしくはキーボード の文字が含まれる項目を検索。テキストフィールドに「US or U.S」 が含まれていたら英語キーボード、「Japanese or JIS or JP」 が含まれていたら日本語キーボードとして判定しています。 |
| ホスト名           | (1)MDMベース    | 一般 > コンピュータ名                     | 一般 > モバイルデバイス名         |                                                                                                                                               |
| SIM番号          | (1)MDMベース    | -                                | ネットワーク > iccid         |                                                                                                                                               |
| 調達方法           | (2)Adminaベース | 購入 >購入またはリース                     | 購入 >購入またはリース           |                                                                                                                                               |
| 購入先            | (2)Adminaベース | 購入 > ベンダー                        | 購入 > ベンダー              |                                                                                                                                               |
| 購入価格           | (2)Adminaベース | 購入 > 購入価格                        | 購入 > 購入価格              |                                                                                                                                               |
| 保証期間           | (2)Adminaベース | 購入 > リース有効期限                     | 購入 > リース有効期限           |                                                                                                                                               |
| 最終利用(MDM)      | (1)MDMベース    | 一般 ＞ 最終チェックイン                    | 一般 ＞ インベントリの最終アップデート   | 新規でカスタム項目を作成せずに、MDM連携が開始されると、自動で作成される項目です。                                                                                                    |
| 管理対象           | (1)MDMベース    | 一般 ＞ 管理対象                        | 一般 ＞ 管理対象              |                                                                                                                                               |
| 管理対象           | (3)MDM項目     | 管理対象：MDM有効                       | 管理対象：MDM有効             |                                                                                                                                               |

### 拡張情報の取得

#### キーボード

キーボードの取得は、JAMF側でスクリプトを組んで、JAMFの拡張属性へ登録することでAdminaへ自動連携されるようになります。この仕組を一度構築すればAdminaまたはJAMF上で1つ1つキーボードを指定して登録しておく必要がありません。

（またMDM連携中は、キーボードフィールドが更新できない様にロックされているので、同期の唯一の方法です）

方法については公式ページ、または有志のブログなどをご参照ください。

JAMF公式ページでの拡張属性の説明

[https://learn.jamf.com/ja-JP/bundle/jamf-pro-documentation-current/page/Computer\_Extension\_Attributes.html](https://learn.jamf.com/ja-JP/bundle/jamf-pro-documentation-current/page/Computer_Extension_Attributes.html)

Too社のブログ

[https://www.too.com/apple/apple\_tips/extended\_attributes.html](https://www.too.com/apple/apple_tips/extended_attributes.html)

Adminaが自動検出するのは以下のルールに合致する場合です。

```
項目名：テキストフィールドより
・項目名にKeyboardもしくはキーボード の文字が含まれる項目を検索。
・テキストフィールドに「US or U.S」 が含まれていたら英語キーボード、「Japanese or JIS or JP」 が含まれていたら日本語キーボードとして判定しています。
```