比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。

弊所学術情報基盤オープンフォーラム2022にて既報のとおり、基地局データの作成を支援するための機能を eduroam JP 申請システムに実装いたしました。従来のようにXML形式のファイルを直接扱うのではなく、spreadsheet に必要な情報を記入していただくことで直感的に作成することができます。同時に eduroam JP 申請システムに登録されている機関情報データとリンクすることにより、入力の効率化も行っていますので、是非、ご活用くださいませ。機関の spreadsheet は eduroam JP 申請システムにログインしていただき、基地局マップデータ タブからダウンロードすることができます。

また、機関責任者・技術担当者向けの eduroam JP 申請システム操作マニュアルも更新しておりますので、あわせてご参照ください。

基地局データを作成する上での勘どころを、こちらのページに随時追記していきます。

基地局データの作成

基地局データは、eduroam.org の定める eduroam database の形式に従います。この仕様はかなり自由度が高く、いろんな記述の仕方が可能になっています。この基地局データに対して厳密な運用ルールは今のところありません。以下に、典型的な記述の仕方を紹介します。

基地局、eduroam database 仕様の原文では eduroam service location ですが、これは要するに eduroam が利用できる場所 です。そこで、まずは次のような問いかけを考えてみましょう。

貴学(貴機関)では、どこで eduroam が使えますか?

この問いかけに回答することを想像してみますと、答え方はたくさんあります。例えば、◯◯キャンパスと◯◯キャンパスで使えます、(◯◯キャンパスの)□□学部棟、…、□□研究科棟で利用できます、などなど。場所を大雑把に捉えるところから細かく指定するところまであり得ますので、eduroam を利用できる場所は次のように分類できるでしょう

  1. キャンパス単位
  2. 建物単位
  3. (さらに細かく)

現運用では場所の粒度について、何も決まりはありません。

キャンパス単位

ここでは大胆にキャンパス単位で eduroam が利用できる場所を記述することを考えます。

eduroam が利用できる場所を記述するには次の情報が必須となっています(他にも必須のものがありますが、ここでは割愛します):

  • 位置の座標(緯度、経度、高度を用います。高度は必須ではありません)
    • 「点」だけでなく、各頂点の座標を指定することにより「多角形」を表現できます
  • 基地局のタイプ
    • 現仕様では single spot, area, mobile の3つがあります

以下では、具体例として A 大学の X キャンパスと Y キャンパスで eduroam が使えるとして説明します。このとき、spreadsheet に記入する必須項目の値は以下のようになるでしょう

項目名必須記入の勘どころ
基地局名称(英語)X Campus, A Universityキャンパス名を記入します
基地局名称(日本語)A大学 Xキャンパス
基地局緯度・経度*35.692712,139.757938キャンパスを指定する代表的な場所の緯度、経度を記入します
基地局運用水準本格運用機関の運用ポリシに応じて選択してください
基地局種別エリアここではキャンパスを「点」で表していますが「エリア」とします。
基地局所在地 都道府県市区町村(英語)Chiyoda-ku, Tokyo例として、Xキャンパスは、東京都千代田区一ツ橋 5-963 にあるとします
基地局所在地 町名番地(英語)5-963 Hitotsubashi
SSIDeduroam

(* 2023/07/10 現在、申請システムからダウンロードできる spreadsheet では、基地局経緯度となっていますが、基地局緯度・経度に更新します)

Yキャンパスについても同様に項目を埋めればよいでしょう。

eduroam JP 申請システムからダウンロードできる spreadsheet は、機関の service location の管理にも利用できるように設計しております。慣れてくれば、キャンパス単位からより細かい単位で service location を記述されることを検討していただければと存じます。

FAQ

機関情報

  • Q: "institution" シートには「機関Web URL」と「機関ポリシURL」なる項目があります。これらはどのようなものでしょうか?
  • A: eduroam database (原文) には次のように説明されています:

    機関Web URLinstitution's web page with the information related to the service
    機関ポリシ URLinstitution's Policy

    従いまして、
    ・機関Web URLには、機関の eduroam サービス情報が掲載されている URL を、
    ・機関ポリシ URLには、機関の eduroam 運用ポリシが掲載されている URL を
    それぞれご記入ください。機関の eduroam サービス情報や運用ポリシが掲載されているページがない場合は、差し当たり機関の URL をご記入ください。当該ページが作成された時点で更新くださいますようお願いいたします。

基地局マップのフォーマット変更

eduroamより、基地局マップのフォーマットを変更するという通知がございました。
切り替え日時は、以下となっています。

新フォーマットへの切り替え日時:2019年11月30日(GMT0:00ごろ、JST9:00ごろ)

新基地局マップの特徴

既存の基地局マップでは、AP設置場所の緯度・経度のみでしたが、新基地局マップでは以下のような特徴が追加されています。

緯度、経度に加えて高度を設定可能

高度を設定できることにより、建物の何階でeduroamを利用できるか提示できるようになります。
なお、高度は省略可能です。

複数の緯度、経度、高度のセットによる範囲の表現

位置情報を記載する<coordinates>タグに、緯度,経度,高度;緯度,経度,高度;……… のように、緯度、経度、高度のセットを「;」で区切って複数(3セット以上)記載することにより、eduroam利用可能範囲を提示することができます。
高度は省略可能です。

新フォーマット

既存のマップフォーマットはお使いいただけませんので、以下の新マップフォーマットにて再作成の上、
eduroam JP申請システムにアップロードしてください。
テンプレートのダウンロードはこちらです。

instid

機関ごとにeduroam JPが割り当てるIDです。eduroam JPでは、e-Rad機関番号としてください。e-Radに登録されていない機関の場合も、eduroam JPでe-Rad機関番号のフォーマットに似た番号を独自に割り当てていますので、eduroam JP申請システムのダッシュボードに表示される「基本情報」の「e-Rad機関番号」を参照してください。

locationid

基地局(AP)ごとにeduroam JPが割り当てるIDです。eduroam JPでは、instid(e-Rad機関番号)_nとし、nには各機関で設置した基地局ごとに1,2,3...と順番に割り当ててください。

コード ブロック
languagexml
title基地局マップ新フォーマット
collapsetrue
<institutions>
<!-- 任意となっているもの以外は必須、以下は記入例 -->
    <institution>
        <instid></instid><!-- instidは基本的にerad機関番号 -->
        <ROid></ROid><!-- 固定 -->
        <type>IdP+SP</type><!-- IdP, SP, IdP+SPから選択 -->
        <stage>1</stage> <!-- 運用フェーズなら1、テスト段階、基地局整備中の場合なら0 -->
        <inst_realm>nii.ac.jp</inst_realm> <!-- レルムを記載(IdPを運用している場合のみ) -->
        <inst_realm>nii.jp</inst_realm> <!-- 複数ある場合は続けて記載 -->
        <inst_name lang="en">National Institute of Informatics</inst_name> <!-- 機関名称(英語) -->
        <inst_name lang="jp">国立情報学研究所</inst_name> <!-- 機関名称(日本語) -->
        
        <address> <!-- 機関所在地(英語) -->
            <street lang="en">2-1-2 Hitotsubashi</street>
            <city lang="en">Chiyoda-ku, Tokyo</city>
        </address>

        <address> <!-- 期間所在地(日本語) -->
            <street lang="jp">一ツ橋2-1-2</street>
            <city lang="jp">千代田区</city>
        </address>

        <coordinates></coordinates> <!-- 機関の緯度、経度、高度(省略可)、任意  -->

        <inst_type>Pero</inst_type> <!-- IEEE 802.11-2012の8.4.1.34節参照、カンマで区切られたペアの数字を記入(任意) -->

        <contact> <!-- 担当者連絡先 -->
            <name>担当者1氏名</name>
            <email>hoge@nii.ac.jp</email>
            <phone>+81xxxxxxxxx</phone>
            <type>0</type>
            <privacy>0</privacy> <!-- 0なら非公開、1なら公開 -->
        </contact>

        <contact>
            <name>担当者2氏名</name>
            <email>moge@nii.ac.jp</email>
            <phone>+81xxxxxxxxx</phone>
            <type>1</type>
            <privacy>1</privacy>
        </contact>

        <info_URL lang="en">http://www.nii.ac.jp/en/</info_URL> <!-- 機関情報のURL -->

        <info_URL lang="jp">http://www.nii.ac.jp/</info_URL>

        <policy_URL lang="en">http://www.nii.ac.jp/en/</policy_URL> <!-- 機関のeduroamポリシーのURL -->

        <policy_URL lang="jp">http://www.nii.ac.jp/</policy_URL>

        <ts>2008-02-29T12:00:00</ts> <!-- 更新日 -->

        <location>
        
          <locationid>Hala-01236_1</locationid> <!-- instidの値_n(n=1,2,3……) -->

          <!-- 緯度、高度、経度(省略可) eduroam利用可能範囲を提示する場合は、多角形の頂点の座標を";"で区切って複数座標セットを記入 -->
          <coordinates>1.23,1.54,147;1.32,1.43,139;1.23,1.23,145</coordinates>

          <stage>1</stage> <!-- 0:テスト運用 1:本運用 -->

          <type>2</type> <!-- coordinatesの表示種別 0:シングルスポット 1:エリア表示 2:モバイル(デフォルト) -->

          <loc_name lang="en">National Institute Informatics 19F</loc_name>

          <loc_name lang="jp">国立情報学研究所19階</loc_name>

          <address> <!-- 機関所在地(英語) -->
              <street lang="en">2-1-2 Hitotsubashi</street>
              <city lang="en">Chiyoda-ku, Tokyo</city>
          </address>

          <address> <!-- 期間所在地(日本語) -->
              <street lang="jp">一ツ橋2-1-2</street>
              <city lang="jp">千代田区</city>
          </address>

          <location_type>Pero</location_type> <!-- IEEE 802.11-2012の8.4.1.34節参照、カンマで区切られたペアの数字を記入,研究開発施設:3,3、大学・短大:2,8(任意) -->

          <contact> <!-- 以下、上の担当者連絡先と同一内容を記入。任意 -->
              <name>担当者1氏名</name>
              <email>hoge@nii.ac.jp</email>
              <phone>+81xxxxxxxxx</phone>
              <type>0</type>
              <privacy>0</privacy>
          </contact>
          <contact>
              <name>担当者2氏名</name>
              <email>moge@nii.ac.jp</email>
              <phone>+81xxxxxxxxx</phone>
              <type>1</type>
              <privacy>1</privacy>
          </contact>

          <SSID>eduroam</SSID> <!-- SSID名称。eduroamとしてください。 -->

          <enc_level>WPA2/AES,WPA/TKIP</enc_level> <!-- 対応している暗号化方式をカンマで区切って記入(任意) -->

          <AP_no>20</AP_no> <!-- 範囲内にある無線APの数、不明な場合は記入なし、あるいは要素そのものを削除でよい(任意) -->

          <wired_no>56</wired_no> <!-- 有線LANコンセントの数(任意) -->

          <tag>IPv6,NAT</tag> <!-- 何らかの制限・拡張がある場合、以下から該当するものを選んで記入(任意)。複数の場合はカンマで区切る:port_restrict、transp_proxy、IPv6、NAT、HS2.0 -->

          <availability>0</availability> <!-- デフォルトは0、物理的アクセス制限があれば1(任意) -->

          <info_URL lang="en">http://www.nii.ac.jp/en/</info_URL> <!-- 機関情報のURL(eduroam関連のWebサイト)(任意) -->

          <info_URL lang="jp">http://www.nii.ac.jp</info_URL>

        </location>

    </institution>

</institutions>

...