10.7. ウェブサービス¶
管理 → 拡張機能 → ウェブサービス （【訳注】 「拡張機能」 は不要）
注釈
ウェブサービスはサイト管理者だけがアクセスできます。
ウェブサービスを使用すると、ウェブサービス/ APIを持つ他のアプリケーションとMaharaサイトを接続することができます。探している統合を達成するためには、いくつかの設定や特定のウェブサービス機能の開発が必要な場合があります。Maharaのウェブサービスは、必要な機能と関連するインタフェース定義をパブリックする関数を定義する以上に多くのことをする必要なしに、追加のAPIを開発するこを可能にするフレームワークです。
In order to use web services, your site must use a SSL certificate. 
When your site is not in production mode, you can test web services without SSL.
10.7.1. 設定 (Configuration)¶
管理 → 拡張機能 → ウェブサービス → 設定 （【訳注】 「拡張機能」 は不要）
このページでは、様々なウェブサービスのルールを設定し、それらを有効または無効にします。
10.7.1.1. Web services master switch and switching protocols on and off¶
ウェブサービスをグローバルに有効にしてから、必要に応じて個別にプロトコルを設定することができます。プロトコルが有効になると、それはすべての機能、ユーザ、およびトークンに使用できます。
ウェブサービスと個々のプロトコルのオンとオフを切り替える
Use web services: If set to 「Yes」, web services are available to be used on your site.
注釈
If you set the master switch to 「No」, any activated individual protocols under 「Protocol」 are turned off and would need to be enabled manually again when you switch web services on again.
SOAP: シンプルオブジェクトアクセスプロトコルを使用できるようにする場合は、このプロトコルを許可します。
XML-RPC: XMLコンテンツへのリモート手続き呼び出しをしたい場合、これを 「Yes」 に設定します。このプロトコルはMNetによって使用されます。
注釈
MNetがMaharaでサポートされる限り、Moodleへの接続を設定する ためにそれを使用することができます。
REST: この設定を 「Yes」 に切り替えることにより、表現可能な状態転送プロトコル (REpresentational State Transfer protocol) を許可します。RESTインタフェースはJSON認証もサポートしています。
OAuth: OAuth（オープン認証）プロトコルを使用する場合は、この設定を 「Yes」 に切り替えます。
10.7.1.2. ネットワーク証明書¶
このセクションでは、便宜上、管理 → サイト設定 → ネットワーキング で作成されたMahara証明書の公開鍵が表示されます。
10.7.1.3. サービスグループを管理する¶
サービスグループは、ユーザへのアクセス（単純認証）またはユーザトークンの割り当て単位です。それらは関数の集まりです。Maharaには、すでに設定可能な一連のサービスグループと機能が用意されています。さらに多くのサービスグループを追加できます。
利用可能なサービスグループの概要とその基本設定
サービス: いくつかの関連する機能をグループ化して有効または無効にできるサービスグループ。
コンポーネント: サービスグループが使用可能なエリア。一般的に 「ウェブサービス」 です。
有効: サービスグループが有効にされている場合、あなたには 有効 アイコン が表示されます。有効にされていない場合、あなたには 無効 アイコン が表示されます。
認証済みユーザだけ: ユーザ名とパスワードでログインしたユーザがサービスグループを使用できる場合は、有効 アイコン が表示されます。このようなユーザとして使用することができない場合は、無効 アイコン が表示されます
ユーザトークンアクセス: このグループの機能にアクセスするためにユーザトークンが必要な場合は、有効 アイコン が表示されます。ユーザトークンによるアクセスが許可されていない場合は、無効 アイコン が表示されます。
関数: これは、サービスグループに関連付けられている関数のリストです。
注釈
関数の一つをクリックすると、この関数のウェブサービスドキュメントが表示されます。関数APIの説明、入出力パラメータ、エラー処理など、ウェブサービス関数に関する詳細情報があります。
編集 ボタン をクリックして、以下で説明するようにサービスグループを変更します。
削除 ボタン をクリックすると、サービスグループが完全に削除されます。
注釈
多くの場合、ウェブサービスグループを再作成し、後で必要になった場合に関数を関連付ける必要があるため、ウェブサービスグループを完全に削除したくない場合があります。グループを無効にするだけで十分な場合があります。
新しいサービスグループを作成する場合は、このフィールドに追加し、追加 ボタンをクリックします。次に、サービスグループのリストで新しいグループを確認し、グループの横にある 編集 ボタン をクリックして設定します。
編集するサービスグループを選択すると、次の画面が表示されます。
サービスグループの設定を編集する
Name of the service group
サービス: このサービスグループを使用する場合は、このスイッチを 「Yes」 に設定します。以下の個々の機能を調整することができます。
認証済みユーザのみ: このサービスグループによってユーザ名とパスワードを持つユーザのみが影響を受ける場合は、このスイッチを 「Yes」 に設定します。
ユーザトークンアクセス: 特定の機能にアクセスするためにユーザに個別のトークンを持たせたい場合は、このスイッチを 「Yes」 に設定します。
注釈
ユーザトークンアクセスは、全体のMaharaユーザベースにAPIを使用する可能性を与えます。一般的に、現在のユーザ自身の詳細については、mahara_user_get_my_userなどのユーザ中心の機能にアクセスできるサービスグループに限定する必要があります。
関数の名前。
有効: この設定は、この関数の使用を有効または無効にします。
クラス名: 関数の一部であるクラスの名前。
メソッド名: 呼び出されているメソッドの名前。このリンクから、そのメソッドのウェブサービスドキュメントに移動します。
変更を完了したら 保存 ボタンをクリックし、変更を取り消す場合は 戻る をクリックします。
10.7.1.4. サービスアクセストークンを管理する¶
個々のユーザのアクセストークンを生成し、そのユーザがアクセスできるサービスグループを関連付けることができます。
アクセストークンの概要
- トークン: 特定のユーザ用に生成されたトークン。
- インスティテューション: ユーザが所属するインスティテューションを一覧表示します。
- ユーザ: 管理者のユーザ名が表示され、ユーザの設定ページにリンクされます。
- サービス: トークンが生成されたサービスグループ。
- 有効: このサービスグループが有効な場合は、有効 アイコン が表示されます。有効になっていない場合は、無効 アイコン が表示されます。
- ウェブサービスセキュリティ: ウェブサービスセキュリティが有効になっている場合は、有効 アイコン が表示されます。それ以外の場合は、無効 アイコン が表示されます。
- 関数: これは、選択したサービスに対してトークンがアクセスできるすべての関数のリストです。
- 編集 ボタン をクリックして設定を変更します。
- 削除 ボタン をクリックしてトークンを削除します。
- ユーザ名: トークンを追加するユーザのユーザ名を入力します。サイトに登録されているユーザの名前またはユーザ名の入力を開始できます。入力時に名前の候補が表示されます。
- そのユーザ用に作成される新しいアクセストークンについては、トークンを生成する ボタンをクリックします。このトークンにサービスグループを関連付けることができる画面が表示されます（下記参照）。一つのユーザ名しか入力できません。
ユーザのトークンを作成するときは、追加情報を入力する必要があります。
サービスアクセストークンを設定する
正しいトークンを編集していることを確認します。
インスティテューション: ユーザのインスティテューションを選択します。
ユーザ名: トークンを設定する正しいユーザ名を持っていることを確認します。ユーザ名は、管理のユーザの設定ページにリンクされています。
サービス: トークンを有効にするサービスグループをドロップダウンリストから選択します。ユーザトークンアクセスを許可するサービスだけを選択できます。
有効: サービスグループが有効になると、トークンは自動的に有効になります。
注釈
サービスグループを無効にする場合は、サービスグループを管理する セクションでそれを行います。
Authorised users only: This checkbox is not used in this context because here you create a token.
関数: トークンがアクセスできる関数のリスト。
注釈
サービスを変更するとき、関数のリストは自動的に更新されません。ページを保存すると、更新されたリストだけが表示されます。
ウェブサービスセキュリティを有効にする（XML-RPCのみ）: この機能は、XML-RPCベースの認証でだけ使用できます。
公開鍵: 追加されたウェブサービスセキュリティの公開鍵を入力します（XML-RPCベースの認証の場合だけ）。
公開鍵の有効期限: 入力した公開鍵の有効期限。日付は、フォームを保存すると更新されます。
変更を完了したら 保存 ボタンをクリックし、変更を取り消す場合は 戻る をクリックします。
10.7.1.5. サービスユーザを管理する¶
ユーザにトークンを使用せず、ユーザ名を使用して機能にアクセスできるようにするには、このオプションを選択する必要があります。ユーザは次のことが必要です：
一度だけ設定される。
メンバーであるインスティテューションで 「ウェブサービス」 認証方法を持っている。
注釈
認証方法 「ウェブサービス」 使用するユーザは、ウェブサービス経由でだけMaharaにアクセスでき、標準ログインフォームを使用することはできません。
サービスユーザを管理する概要セクション
- ユーザ: サービスグループを設定したユーザのユーザ名が表示されます。これは、管理のユーザの アカウント設定ページ にリンクされています。
- インスティテューション: ユーザが所属するインスティテューションを一覧表示します。
- サービス: ユーザに関連付けられているサービスグループ。
- 有効: このサービスグループが有効な場合は、有効 アイコン が表示されます。有効になっていない場合は、無効 アイコン が表示されます。
- ウェブサービスセキュリティ: ウェブサービスセキュリティが有効になっている場合は、有効 アイコン が表示されます。それ以外の場合は、無効 アイコン が表示されます。
- 関数: これは、ユーザが選択したサービスに対してアクセスできるすべての関数のリストです。
- 編集 ボタン をクリックして設定を変更します。
- 関連するサービスグループへのアクセスからユーザを削除するには、削除 ボタン をクリックします。
- ユーザ名: サービスを管理するユーザのユーザ名を入力します。サイトに登録されているユーザの名前またはユーザ名の入力を開始できます。入力時に名前の候補が表示されます。ユーザは認証方法としてウェブサービスを持っている必要があります。
- そのユーザ用に作成される新しいアクセストークンについては、トークンを生成する ボタンをクリックします。このトークンにサービスグループを関連付けることができる画面が表示されます（下記参照）。一つのユーザ名しか入力できません。
ユーザを追加するときは、追加情報を入力する必要があります。
ユーザを特定のサービスグループに関連付ける
サービスオーナ: ユーザ名が表示されます。以下のユーザ名と一致する必要があります。
インスティテューション: ユーザのインスティテューションが正しいことを確認します。そうでない場合は、ユーザの アカウント設定ページ でインスティテューションを変更することができます。
ユーザ名: トークンを設定する正しいユーザ名を持っていることを確認します。
サービス: ユーザにアクセスを許可するサービスグループをドロップダウンメニューから選択します。ユーザ名によるアクセスを許可するサービスだけが選択できます。
有効: サービスグループが有効になると、設定は自動的に有効になります。
注釈
サービスグループを無効にする場合は、サービスグループを管理する セクションでそれを行います。
Authorised users only: This checkbox is selected automatically when the service group is configured to allow access via a username.
関数: ユーザがアクセスできる関数のリスト。
注釈
サービスを変更するとき、関数のリストは自動的に更新されません。ページを保存すると、更新されたリストだけが表示されます。
ウェブサービスセキュリティを有効にする（XML-RPCのみ）: この機能は、XML-RPCベースの認証でだけ使用できます。
公開鍵: 追加されたウェブサービスセキュリティの公開鍵を入力します（XML-RPCベースの認証の場合だけ）。
公開鍵の有効期限: 入力した公開鍵の有効期限。日付は、フォームを保存すると更新されます。
変更を完了したら 保存 ボタンをクリックし、変更を取り消す場合は 戻る をクリックします。
10.7.2. OAuthサービス登録¶
管理 → 拡張機能 → Webサービス → OAuth （【訳注】 「拡張機能」 は不要）
OAuthサービスへのアクセスは個別に設定されます。これにより、コンシューマーキーと秘密鍵が自動的に生成されるインスティテューションとサービス定義の選択が可能になります。
OAuthサービスを登録する
- アプリケーション：OAuth経由で接続されているアプリケーションを一覧表示します。
- オーナ：OAuthサービスを設定したユーザ。
- コンシューマキー：OAuthサービスのコンシューマキー。
- コンシューマ秘密鍵：OAuthサービスのコンシューマ秘密鍵。
- 有効：アプリケーションが有効な場合は、有効 アイコン が表示されます。有効になっていない場合は、無効 アイコン が表示されます。
- コールバックURI: アプリケーションのコールバックURI。
- 編集 ボタン をクリックして設定を変更します。
- 削除 ボタン をクリックして、アプリケーションを削除して、OAuth経由でMaharaに接続できなくなるようにします。
- アプリケーション：アプリケーションに名前を追加するよう指示します。
- どのインスティテューションがOAuthを介して選択したアプリケーションにアクセスできるかを選択します。
- このアプリケーションに関連付けるサービスグループを選択します。
- 追加 ボタンをクリックして、選択したサービスのOAuth認証を作成します。アプリケーションを設定できる画面が表示されます（下記参照）。
アプリケーションがOAuthを介してMaharaに接続されるようにするには、さらに情報を提供する必要があります。
OAuthサービスを設定する
サーバキー: OAuthサービスのコンシューマキー。
コンシューマ秘密鍵：OAuthサービスのコンシューマ秘密鍵。
アプリケーションタイトル: アプリケーションに名前を追加するよう指示します。
サービスオーナ: OAuthサービスを設定したユーザ。
アプリケーションURI: アプリケーションのURI。
コールバックURI: アプリケーションのコールバックURI。
インスティテューション: OAuthを設定するインスティテューションを選択します。
サービス: OAuth用に設定するサービスグループを選択します。
有効: OAuthが有効な場合、アプリケーションは自動的に有効になります。
関数: アプリケーションがアクセスできる関数のリスト。
注釈
サービスを変更するとき、機能のリストは自動的に更新されません。ページを保存すると、更新されたリストだけが表示されます。
変更を完了したら 保存 ボタンをクリックし、変更を取り消す場合は 戻る をクリックします。
10.7.3. ウェブサービスログ¶
管理 → 拡張機能 → ウェブサービス → ログ （【訳注】 「拡張機能」 は不要）
ウェブサービスからログを表示し、検索範囲を絞り込むことで、関連する情報だけを表示することができます。
ウェブサービスログを検索する
- ユーザ: ログを表示するユーザのユーザ名を入力します。一つのユーザ名しか入力できません。サイトに登録されているユーザの名前またはユーザ名の入力を開始できます。入力時に名前の候補が表示されます。
- プロトコル: あなたには現在有効にされているウェブサービスプロトコルだけが表示されます。一つ以上のプロトコルが表示されている場合、あなたがテストしたい一つを選択します。
- 認証タイプ: ユーザに対して選択した認証のタイプを選択します。オプションは次のとおりです：
- すべて: 任意の認証タイプのログを表示します。
- トークン: ユーザがユーザトークンを持っているときだけログを表示します。
- ユーザ: ユーザがウェブサービスのユーザ名を使用するとログを表示します。
- OAuth: ユーザがOAuth経由でログインしたときにだけログを表示する場合は、このオプションを選択します。
- 関数: 興味のある関数を検索します。
- Only errors: Tick this checkbox if you only want to see log information that contains an error.
- 検索を開始するには Go ボタンをクリックします。
検索結果がある場合は、結果 エリアに表示されます。
ウェブサービスログの検索結果
- ユーザ: ログエントリがあるユーザのユーザ名を表示します。
- インスティテューション: ユーザがメンバーであるインスティテューション名を表示します。
- プロトコル: 選択したコンテキストのユーザに関連付けられているプロトコルを表示します。
- 認証タイプ: ユーザに関連付けられている認証タイプが表示されます。
- 関数: ログエントリがある関数を表示します。
- 取得時間: ログエントリを取得するまでにかかった時間。
- When: ログエントリが作成された日付を表示します。
- 列のタイトルをクリックすると、列のソート順を変更できます。
- Info: ここにエラーメッセージが表示されます。
10.7.4. ウェブサービステストクライアント¶
管理 → 拡張機能 → ウェブサービス → テストクライアント （【訳注】 「拡張機能」 は不要）
テストクライアントは、設定をテストする機会を与えます。これらの機能は、別々のテストインスタンスではなく、システム上で実行されることに注意します。
ウェブサービステストクライアント
注釈
設定を開始すると、一つのプロトコルしか選択されていない場合、プロトコルと認証タイプが表示されます。他のフィールドは、何をテストするか決定した後に明らかになります。
プロトコル: あなたには現在有効にされているウェブサービスプロトコルだけが表示されます。一つ以上のプロトコルが表示されている場合、あなたがテストしたい一つを選択してください。
認証タイプ: あなたのテストに含みたい認証タイプを選択します。次のオプションを表示するには 次へ ボタンをクリックします。
サービス: あなたのテストに含みたいサービスグループを選択します。次のオプションを表示するには 次へ ボタンをクリックします。
関数: テストに含める関数を選択します。次へ ボタンをクリックすると、次のオプションが表示されます。
wstoken: あなたがテストしたいユーザのウェブサービストークンを入力します。
注釈
あなたが認証タイプの 「ユーザ」 を選択した場合、あなたが入力することのできる wspassword フィールドも表示されます。
あなたがテストを実行したい場合、実行 ボタンをクリックします。あなたがテストを中止したい場合、キャンセル をクリックします。
テストが実行された場合、画面にテスト結果が表示されます。
10.7.5. アプリケーション接続¶
管理 → 拡張機能 → ウェブサービス → アプリケーション接続 （【訳注】 「拡張機能」 は不要）
これは、個人のユーザトークンまたはOAuthアクセストークンを使用して許可したすべての接続の概要ページです。
アプリケーション接続概要
パーソナルユーザトークン セクションには、個々のユーザに対して生成したトークンと、それらのトークンがアクセスされたかどうかが表示されます。
サービスアクセス: このカラムではあなたがトークンを作成したサービスグループが表示されます。
有効: サービスグループが有効にされている場合、有効 アイコン が表示されます。有効にされていない場合、無効 アイコン が表示されます。
トークン: ここにトークンが表示されます。
関数: サービスグループの一部である関数がリストされ、リンクされています。リンクは、選択した関数のウェブサービスのドキュメントに移動します。
最終アクセス: トークンの最後の使用日時をリストします。
有効期限: トークンの有効期限を表示します。
新しいランダムトークンを生成するには 生成 ボタンをクリックします。
削除 ボタン をクリックしてトークンを削除します。ユーザグループと関数は引き続き使用できます。次に、生成 ボタンをクリックして新しいトークンを作成します。
注釈
トークンが生成されている場合だけ 削除 ボタンを使用することができます。
あなたはOAuthで使用するために生成されたトークンを*OAuthアクセストークン*セクションで確認することができます。