パッケージエディター

パッケージからパッケージを開く（またはカタログのページで編集を選ぶ）と、エディターが開きます。エディターのサイドバーは、アプリケーションのサイドバーの代わりに表示されます。

• 戻るためのマイパッケージ、パッケージの選択欄（別のパッケージを選ぶと、そのパッケージの同じセクションが開きます）、そして保存状態：保存済み、保存中…、オフライン：変更は保持されます、未保存：再試行中。
• プラットフォームのテナントメニューと同じ構成のセクション：概要、ノード管理（メーカー、モデル、SNMP と CLI を含むプロファイル。近日公開と表示された項目は今後のバージョンで追加されます）、続いてバージョン。
• 下部の設定。

リアルタイムの共同編集

エディターに保存ボタンはありません。すべての変更は入力と同時に保存されます。複数の編集者が同じパッケージを同時に編集できます。他の人の変更は入力と同時に表示され、サイドバーには編集中の人が表示され、他の人が編集している欄はその人の色で囲まれます。接続が切れても変更は保持され、接続が戻ったときに送信されます。

変更は、バージョンを公開 するまでプラットフォームには届きません。コンテンツが最後のバージョンと異なる場合、各セクションのヘッダーに未公開の変更と表示されます。

一覧と項目のページ

コンテンツの各部分は、検索ボックス付きの表になっています。メーカー、モデル、SNMP プロファイル、CLI プロファイル、プロファイルです。行を選択すると、複数の項目を一度に削除できます。上部の 新しい … ボタンを押すと、名前（といくつかの必須項目）を求められ、その後新しい項目のページが開きます。残りの内容は、そのページでタブごとに入力します。

メーカー

メーカーは、MikroTik のようなネットワーク機器のベンダーです。新しいメーカーを押すと名前を求められます。メーカーのページには一般とモデルの 2 つのタブがあります。

フィールド	内容
名前	必須。
ロゴ	PNG、SVG、JPEG、WebP で、最大 512 KB。そのモデルにも表示されます。
Web サイト	https://www.example.com
サポートサイト	https://support.example.com
サポート窓口	メールアドレスまたは電話番号：support@example.com
説明	プラットフォームでメーカーと一緒に表示されます。

モデルで使われているメーカーは削除できません。先にモデルに別のメーカーを割り当てるか、モデルを削除してください。

モデル

モデルは、CRS326-24G-2S+ のような、パッケージのメーカーの機器の種類です。新しいモデルを押すと、名前とメーカーを求められます（先にメーカーを追加してください：モデルは必ずメーカーに属します）。モデルのページには 2 つのタブがあります。

• 一般：名前、メーカー（メーカーのロゴがモデルのロゴになります）、説明。
• 接続：機器で CLI セッションを開いた後のプラットフォームの動作。

フィールド	内容
制御キー	なし、または Ctrl-A〜Ctrl-Z の制御文字。接続を開いた直後、スクリプトの前に送信されます。スイッチによっては、バナーで Ctrl-Y を待つものがあります。
接続スクリプト	接続後、制御キーの後に 1 行ずつ入力される行。通常はページングをオフにするコマンドです。最大 200 行、10 000 文字です。

特権モードが必要で、ページングをオフにするスイッチの接続スクリプトの例：

enable
terminal more disable

別のベンダーであれば、terminal length 0 の 1 行だけの場合もあります。

SNMP プロファイル

プラットフォームが機器と SNMP で通信する方法です。新しい SNMP プロファイルを押すと、名前とバージョン（SNMPv1、SNMPv2c、SNMPv3）を求められます。ページには 2 つのタブがあります。

• 一般：名前、バージョン、ポート（空欄の場合は 161）、説明。
• 認証情報：バージョンによって異なります。該当しない欄は非表示になり、消去されます。

SNMPv1 / SNMPv2c

フィールド	例
コミュニティ	public（SNMPv1 と v2c では平文で送信されます）

SNMPv3

フィールド	例
ユーザー名	snmpadmin（SNMPv3 のユーザー）
セキュリティレベル	認証と暗号化 (authPriv)。ほかに noAuthNoPriv と authNoPriv もあります
認証プロトコル	SHA-256（MD5、SHA-1、SHA-224、SHA-384、SHA-512 も選べます。プラットフォームでは MD5 と SHA-1 は MD-5 と SHA と表示されます）
認証パスワード	s3cr3t-example、8 文字以上
暗号化プロトコル	AES-128（DES、AES-192、AES-256 も選べます）
暗号化パスワード	s3cr3t-example、8 文字以上
コンテキスト名	任意

CLI プロファイル

プラットフォームがコマンドラインセッションを開く方法です。新しい CLI プロファイルを押すと、名前とプロトコル（SSH または Telnet）を求められます。タブは次のとおりです。

• 一般：名前、プロトコル、ポート（空欄の場合は SSH で 22、Telnet で 23）、説明。
• 認証情報：ユーザー名（任意：Telnet ではパスワードだけでログインする場合があります）、認証方式（パスワードまたは秘密鍵）、パスワード、enable パスワード（任意。特権モード用）。

秘密鍵がパッケージに含まれることはありません。秘密鍵を選んだ場合、鍵とそのパスフレーズは各プラットフォームで設定します。

プロファイルで使われている SNMP プロファイルや CLI プロファイルは削除できません。先にプロファイルに別のものを割り当てるか、プロファイルを削除してください。

プロファイル

プロファイルは、ある種類の機器に接続するためのあらかじめ用意された方法を、1 つの名前でまとめたものです。SNMP プロファイル、CLI プロファイル、またはその両方に加え、機器に必要なその他のログイン情報や値を含みます。プラットフォームでは、ノード管理 › プロファイルに表示されます。

新しいプロファイルを押すと、名前（例：Campus access switch）、SNMP プロファイル、CLI プロファイルを求められます（少なくとも一方を選びます。先に SNMP と CLI で追加しておいてください）。プロファイルのページには、一般、追加の認証情報、カスタム変数の 3 つのタブがあります。

追加の認証情報

SNMP プロファイルと CLI プロファイル以外の、機器へのその他のログイン情報です（Web インターフェース、API など）。新しい認証情報を押すとダイアログが開き、名前（例：Web UI、REST API）、ユーザー名、パスワードを入力します。1 プロファイルあたり最大 20 件で、それぞれ一意の名前が必要です。表には、パスワードの代わりに保存済みと表示されます。

カスタム変数

その他のあらゆる用途のための自由な値です（アドレス、ポート、API パス、トークンなど）。新しい変数を押すとダイアログが開きます。

フィールド	ルール
名前	英字、数字、_ を使い、数字で始めず、プロファイル内で一意にします：api_url
値	自由なテキストで、空でもかまいません：https://192.0.2.10:8443/rest
シークレット	オンにすると、値はここでは隠され、プラットフォームでは暗号化されます。
説明	任意、1 行。

1 プロファイルあたり最大 50 件です。値は書かれたとおりに使われ、プラットフォームの各テナントは独自の値を設定できます。追加認証情報とカスタム変数 を参照してください。

例：すぐに使えるプロファイル

このページで使っているパッケージ Campus switching profiles には、2 つのプロファイルが含まれています。1 つ目の Campus access switch は、次のものを組み合わせています。

部分	内容
SNMP プロファイル	Campus SNMPv3 (authPriv)：SNMPv3、ポート 161、ユーザー campus-monitor、SHA-256 と AES-128
CLI プロファイル	Campus SSH：SSH、ポート 22、ユーザー netops、パスワードと enable パスワード
追加の認証情報	Web UI：admin / s3cr3t-example
カスタム変数	syslog_server = 192.0.2.10（キャンパスの syslog コレクター）

2 つ目の Campus legacy switch は、Campus SNMP v2c（コミュニティ public）と Campus Telnet console を組み合わせています。パッケージをインストールしたプラットフォームでは、これらのプロファイルをすぐに使えます。各テナントは、例の値を独自の値に置き換えます。

パッケージ内のシークレット

パッケージ内の値は、ダウンロードした人なら誰でも読めます

コミュニティ、パスワード、追加の認証情報、シークレットの変数は、エディターではマスクされています（目のボタンで値を表示できます）が、パッケージファイル内では平文で扱われます。パッケージをダウンロードできる人なら誰でも読めます。エディターでは、すべての認証情報タブにその旨が表示されます：このパッケージをダウンロードできる人は誰でもこれらの値を読めます。ベンダーの既定値 (public や rwa など) だけにしてください。各プラットフォームで独自の値を設定できます。

パッケージに入れるのは、メーカーが公開している工場出荷時のコミュニティやアカウントなど、ベンダーの既定値だけにしてください。ネットワークの実際の認証情報は絶対に入れないでください。

プラットフォームでは、これらの値は暗号化して保存され、各テナントが独自の値で上書きできます。パッケージのカタログページには、認証情報と変数の名前は表示されますが、値は表示されません。

コンテンツのエラー

保持できない内容がある場合（メーカーのないモデル、1〜65535 の範囲外のポート、8 文字未満の SNMPv3 パスワード、重複した名前など）、その欄に理由が表示され、タブまたは行に警告アイコンが表示されます。公開する前に修正してください。