12. LTI経由の外部アプリ

他のアプリケーションをMaharaに接続するため ウェブサービス および認証方法を使用できます。捜している統合のタイプに依存するため、接続をMahara自体に簡単に設定できるかもしれません。他の場合、いくつかの開発作業が必要であるかもしれません。

Learning Tools Interoperability <http://www.imsglobal.org/activity/learning-tools-interoperability> (LTI) は毎回複雑な詳細な設定をせずに簡単に接続して学習管理システム (LMS) のようなアプリケーションが標準的な方法で相互に情報交換できるようにします。

現在のところ、Maharaは認証目的のためのLTIをサポートします。

以下では、あなたがLTIを経由でMaharaをいくつかの学習管理システムにどのようにして接続できるかを述べます。

12.1. Maharaの設定

認証目的のためにLTIを使用するために、あなたはLMSだけでなくMaharaの設定を完了する必要があります。

手順はCanvasとMoodleの最近のものに提供されます。あなたが別のLMSを使う場合、どうぞ、どのようにLTI接続を設定するかについてそのドキュメンテーションをチェックします。

12.1.1. サイトのためにLTIを有効にする

あなたはあなたのMahraサイトのためにLTIが有効であることを保証する必要があります。 あなたは プラグイン管理それを活性化する ことでそのことを行います。

The LTI plugin is enabled

LTIプラグインは有効である

プラグインのページに警告サインがなくて、上部のテキストに 「LTI APIは有効である」 が表示されている場合、LTIプラグインは有効です。

12.1.2. インスティテューションのためのLTIを有効にする

あなたはサイト管理者としてインスティテューションのためのLTIを有効にできます。インスティテューション管理者は自身のインスティテューションのためのLTIを設定できません。

Enable LTI for an institution

インスティテューションのためのLTIを有効にする

  1. 管理 → 拡張機能 → ウェブサービス → 外部アプリ へ行きます。

  2. アプリケーション: あなたが接続したいあなたのアプリケーションに名前を与えます。これはあなただけが理解している必要がある識別子です。

  3. アプリケーションを設定したいインスティテューションを選択します。

  4. ドロップダウンメニューから 「LTI統合」 を選択します。

  5. コンシューマキーと秘密鍵を生成するために 追加 ボタンをクリックします。

    注釈

    あなたのインスティテューションが 「ウェブサービス」 認証方法をまだ持っていない場合、それは自動的に追加されます。

  6. 詳細オプションを見て、それらについての決定をしたい場合、管理 ボタン をクリックします。

    注釈

    現在のところ、ユーザがLTI経由で初めてログインするとき、あなたはユーザを自動的に作成させることを選ぶことができるだけです。スイッチを 「Yes」 にセットすることは、そのとき、あなたのLMSからの任意のユーザは、アカウントを前もって設定する必要なしにMaharaに直接入ることができるので、一般によいことです。

    別の認証方法によってLTIを使用することについての詳細については、さらに下に見てください。

12.2. 二番目の認証方法としてLTIを使用する

あなたのユーザが同じインスティテューション内のLTIおよび別の認証方法を使用してログインできるようにすることができます。二つの可能な方法があります:

  1. ユーザは最初にMahara経由で、その時だけLTI経由でログインします。

  2. ユーザは最初にLTI経由で、それからMahara経由でログインします。

あなたが彼らのアカウント設定を手動で調整する必要がないので、最初のケース〈最初にユーザがMahara経由でログインする〉は、より容易なものです。ユーザが最初にLTI経由でログインする場合、彼らの認証方法は、彼らが二つのアカウントによって終わらないように調整される必要があります。

技術的に、あなたはMaharaでMNetを含む、LTIの2番目の認証方法として利用可能である任意の認証方法を使用できます。しかし、MNetはあなたがMaharaホームページ経由でログインすることを許可していないため、LTIはMNetの代わりです。この認証方法は接続するものとして記載されていません。

SAML認証方式 は、LTIに対する親認証方式として設定できます。これにより、人々はSAMLまたはLTIを介してログインし、同じアカウントに入ることができます。

注釈

現在のところ、これはSAML認証でだけ可能ですが、LDAP / Active Directoryやサードパーティの認証方式では使用できません。

Set a parent authentication method for LTI

LTIの親認証方法を設定する

  1. 管理 → ウェブサービス → 外部アプリ のLTIアプリケーションの横にある 管理 ボタン をクリックします。

  2. インスティテューション: LTIアプリケーションを作成したインスティテューションが一覧表示されます。

  3. ユーザの自動作成: LTIリンクにアクセスできるユーザが自動的にアカウントを作成できるようにするには、 「Yes」 に切り替えます。

  4. 親認証: LTIの親であるべき認証方法を選択し、人々が両方を介して直接ログインして同じアカウントに入るようにします。

12.2.1. MaharaそれからLTI経由でログインする

あなたのユーザはMaharaとLMS経由でログインできます。

  1. あなたのユーザが使用する認証方法があなたのインスティテューションのために設定されることを保証します。

  2. あなたがウェブサービスをあなたのインスティテューションのために認証方法として設定することを確認します。

  3. 「インスティテューションのためのLTIを有効にする」 の下で説明されるように、LTI統合のためのコンシューマ秘密鍵とコンシューマキーを設定します。

  4. 選択するあなたのLMSでの統合の設定を完了します。

  5. あなたのユーザに、最初にMaharaにログインし、彼らのアカウントを 手動で または CSVファイル 経由で設定し、彼らのアカウントを LDAP 経由で同期し、あるいは最初のログイン時に SAML によってアカウントを自動作成するように頼みます。

ユーザとして:

  1. Maharaホームページにログインします。

  2. まだ存在していない場合、あなたのアカウントは設定されます。

  3. あなたのLMSに行きます。

  4. あなたをあなたのポートフォリオに連れて行くリンクをクリックします。あなたがポートフォリオを作成することを頼まれるコース、またはあなたのLMSのあなたのプロファイルページで、そのリンクをしばしば見つけることができます。

  5. あなたはすでにあなたがMaharaに設定していたのと同じアカウントへのアクセスを得ます。

12.2.2. LTI経由でそれからMaharaにログインする

あなたがあなたのユーザに最初にLTI経由で、それからMaharaにログインして欲しい場合、あなたはユーザの認証方法を2番目の認証方法、すなわち内部の、LDAP、SAMLまたはIMAP、主要なもの、に変更する必要があります。

以下はワークフローについて説明します。最初にLTI経由でログインした場合、両方の認証方法を使用してユーザがログインすることを可能にするために取る必要があるステップを含みます。

  1. あなたのユーザが使用する認証方法があなたのインスティテューションのために設定されることを保証します。

  2. あなたがウェブサービスをあなたのインスティテューションのために認証方法として設定することを確認します。

  3. 「インスティテューションのためのLTIを有効にする」 の下で説明されるように、LTI統合のためのコンシューマ秘密鍵とコンシューマキーを設定します。

  4. 選択するあなたのLMSでの統合の設定を完了します。

  5. あなたのユーザはLMSに行き、ポートフォリオへのリンクをクリックします。それはユーザのためのアカウントを作成します。

    警告

    あなたが物事をここに残し、次のステップを続行しないで、ユーザがMaharaホームページ経由でログインする場合、ユーザ2番目のアカウントが作成されます。

  6. ユーザの認証方法を非LTIのものに変更します。SAMLプラグインを介したシングルサインオンの場合、あなたはリモートユーザ名を提供する必要があります。

    参考

    内部およびLDAPアカウント および リモートユーザ名を必要とする ための認証方法をどのようにして変更するかを学べます。

12.3. Canvasでの設定

マハラへのLTI接続は、Canvasのすべてのコースまたは単一のコースのいずれかに設定できます。

Canvasのインスタンス全体の接続を設定する利点は、教師が自分で接続を設定する必要がなく、誰もが同じMaharaのインスタンスと同じインスティテューションに接続することです。

あなたの学習者が接続するMaharaのどのインスティテューションをより詳細に制御したい場合は、コースレベルでLTI接続を設定できます。

Edu App Centerまたは手動設定で接続を設定できます。手動設定では、MaharaをCanvasではなく独自のウィンドウで開けます。

12.3.1. Edu App Centerを介した設定

Edu App CenterでMaharaを設定した場合、MaharaのインスタンスがCanvas内のiframeとして開かれ、Maharaを表示できるスペースが減ります。Canvasナビゲーションも常に表示されます。

警告

セキュリティ上の理由から、Maharaは別のウェブサイトにiframeとして埋め込まれることを防ぎます。Edu App Centerを使用し、手動でMaharaを設定しない場合(わずかに長い設定時間)、Maharaのセキュリティ機能を無効にする必要がありますが、これはお勧めできません。あなたのconfig.phpに$cfg->sameoriginframes = false; を追加することでそうすることができます。

参考

別のウィンドウでMaharaを開くには、その 設定手順 に従います。

Choose Mahara from the Edu App Center

Edu App CenterからMaharaを選択する

  1. Canvasサイトまたはコースで 設定 をクリックします。

    注釈

    あなたのサイトにリンクを置くことを選択した場合、すべてのコースはナビゲーションにリンクを持ちます。リンクを自分のコースに入れることに決めた場合、コース参加者だけがMaharaにアクセスできます。

  2. アプリ タブをクリックします。Edu App Centerにアクセスできます。

  3. 検索欄で 「mahara」 を検索します。

  4. あなたに提示されているMaharaアプリをクリックします。あなたは、アプリ自体についてさらに詳しい情報を表示する画面に移動します。

  5. アプリを追加する ボタンをクリックして設定を開始します。

Maharaへの接続を追加するには、コンシューマキーとコンシューマ秘密鍵が必要なため、Maharaに 外部ツール としてCanvasを設定する必要があります。

Configure Mahara via the Edu App Center

Edu App CenterでMaharaを設定する

  1. 名称: あなたはあなたがアプリを呼び出すことを決定できます。ここで選択した名称はコースのナビゲーションに表示される名称になります。

  2. コンシューマキー: 前に設定したLTI接続用のMaharaのコンシューマキーを貼り付けます。

  3. 共有秘密鍵: 前に設定したLTI接続のMaharaからのコンシューマ秘密鍵を貼り付けます。

  4. 起動URL: MaharaインスタンスのURLを貼り付けます。

  5. アプリを追加する ボタンをクリックして設定を完了します。

  6. 閉じる ボタンまたは 閉じる アイコン をクリックして設定を中止します。

  7. ページを更新した場合、あなたのコースナビゲーションにアプリが表示されます。

  8. Maharaのインスタンスで認証されるアプリをクリックします。

    注釈

    あなたがすでにCanvasで使用している電子メールアドレスを持つMaharaのインスティテューションにアカウントを持っている場合は、そのアカウントに移動します。

    メールアドレスがMaharaにまだ存在せず、自動アカウント作成が許可されている場合は、アカウントが設定されます。

    電子メールアドレスがMaharaに存在するが、Canvas統合を設定しているインスティテューションのメンバーでない場合は、エラーメッセージが表示され、Canvas経由でログインする前にそのインスティテューションのメンバーになる必要があります。

12.3.2. 手動設定

Maharaへの接続の手動設定も簡単です。

Choose to set up Mahara manually

手動でMaharaを設定するように選択する

  1. Canvasサイトまたはコースで 設定 をクリックします。

    注釈

    あなたのサイトにリンクを置くことを選択した場合、すべてのコースはナビゲーションにリンクを持ちます。リンクを自分のコースに入れることに決めた場合、コース参加者だけがMaharaにアクセスできます。

  2. アプリ タブをクリックします。

  3. アプリの設定を表示する ボタンをクリックします。

  4. アプリ ボタンをクリックして、Maharaアプリを手動で追加します。

Maharaインスタンスの詳細をポップアップウィンドウに追加します。

Configure the connection to Mahara

Maharaへの接続を設定する

  1. 設定タイプ: 「URL別」 を選択します。設定パラメータはMaharaインスタンスで使用できます。

  2. 名称: あなたはあなたがアプリを呼び出すことを決定できます。ここで選択した名称はコースのナビゲーションに表示される名称になります。

  3. コンシューマキー: 前に設定したLTI接続用のMaharaのコンシューマキーを貼り付けます。

  4. 共有秘密鍵: 前に設定したLTI接続のMaharaからのコンシューマ秘密鍵を貼り付けます。

  5. URLを設定する: MaharaインスタンスのURLを貼り付け、最後に次を追加します: /module/lti/configxml.php

  6. 送信 ボタンをクリックして設定を完了します。

  7. 設定を中止するには、キャンセル ボタンまたは 閉じる アイコン をクリックします。

  8. ページを更新した場合、あなたのコースナビゲーションにアプリが表示されます。

  9. Maharaのインスタンスで認証されるアプリをクリックします。

    注釈

    あなたがすでにCanvasで使用している電子メールアドレスを持つMaharaのインスティテューションにアカウントを持っている場合は、そのアカウントに移動します。

    メールアドレスがMaharaにまだ存在せず、自動アカウント作成が許可されている場合は、アカウントが設定されます。

    電子メールアドレスがMaharaに存在するが、Canvas統合を設定しているインスティテューションのメンバーでない場合は、エラーメッセージが表示され、Canvas経由でログインする前にそのインスティテューションのメンバーになる必要があります。

12.4. Moodleでの設定

あなたはMoodleで使用するために二つの異なる方法でMaharaを設定できます:

  • 教師は技術の詳細を必要としないので、教師のために設定を容易にするサイトレベルでの一般設定

  • コースレベルでの手動設定

12.4.1. 使用するすべてのコースのためにLTIを事前に設定する

サイト管理 → プラグイン → 活動モジュール → 活動の管理 → あらかじめ設定されたツールを編集する に行きます

Configure Moodle to connect to Mahara

Maharaに接続するためにMoodleを設定する

  1. ツール名: あなたの教師が認識する名前を与えます。

  2. ツールのURL: 開始URLを提供します。それはあなたのMaharaサイトのベースURLとその終わりに追加される次のものからなります:/webservice/rest/server.php?wsfunction=module_lti_launch

  3. ツールの説明: このフィールドは省略可能です。説明を提供することは、教師がツールをもっと容易に識別するのを助けます。

  4. コンシューマキー: 前にあなたが設定したLTI接続のためにMaharaからコンシューマキーを貼り付けます。

  5. 共有秘密鍵: 前にあなたが設定したLTI接続のためにMaharaからコンシューマ秘密鍵を貼り付けます。

  6. デフォルトの起動コンテナ: 「新規ウィンドウ」 または 「既存ウィンドウ」 を選択します。Maharaを埋め込むことを選択しないでください。あなたが他のウェブサイトにMaharaを埋め込むことは許されていないので、それは機能しません。さらに、それはあなたがMaharaで作業することができるスペースを減らすでしょう。

  7. セキュアなアイコンURL: 外部ツール用の標準のMoodleアイコンを表示したくない場合は、お気に入りのアイコンへのリンクを提供できます。Maharaサイトにいて、最良の結果を得るためにMoodleが必要とするサイズを提供することをお勧めします。

  8. SSLを強制する: (あなたはテストインスタンスを持っていない限り)SSL経由のみでMaharaでLTIを使用できます。このボックスを選択した場合、SSLのみでの接続を確認できます。そのためには、MoodleもSSL経由で動作する必要があります。これが推奨されます。

  9. 設定を保存するには 変更を保存する ボタンをクリックし、ツールの設定を中止する場合は キャンセル ボタンをクリックします。

注釈

ページ上の他の設定を変更する必要はありません。

12.4.2. コースで事前設定されたMaharaサイトを使用する

MoodleのサイトレベルでMaharaが すでに外部ツールとして設定されている 場合、教師はMoodleの 「外部ツール」 活動を追加する際にそれを選択する必要があります。

Choose a preconfigured Mahara instance in Moodle

Moodleであらかじめ設定されたMaharaインスタンスを選択する

  1. 活動名: 活動にタイトルを付けます。

  2. 事前設定済みのツール: ドロップダウンメニューからMaharaインスタンスを選択してください。それは「Mahara」であるかもしれません。このオプションを選択した場合、既存のサイト全体の設定によって決定されるため、一部のフィールドは編集できません。

    注釈

    追加の変更を加える場合は、もっと見る … リンクをクリックします。

  3. 保存してコースに戻る ボタンをクリックしてコースページに戻り、保存して表示する ボタンをクリックしてMaharaにすぐにアクセスするか、キャンセル ボタンをクリックしてコースに活動として追加します。

12.4.3. 手動でコース活動でMaharaを設定する

Maharaへの接続は、サイトレベルで最初に設定しなくてもMoodleの活動レベルでも設定できます。これは、他のコースにアクセスできない特定のMaharaサイトに接続している唯一のコースであれば有益です。

誰もが同じMaharaサイトにアクセスできるようにするには、サイトレベルで事前設定を行うことをお勧めします。

Set up Mahara as external tool in a Moodle course

Moodleコースの外部ツールとしてMaharaを設定する

  1. 活動名: 活動にタイトルを付けます。

  2. 活動の説明: 活動の説明を入力します。このフィールドは省略可能です。

  3. 事前設定ツール: 「ツールURLに基づいて自動」 を選択します。

  4. セキュアツールURL: 起動URLを入力します。MaharaサイトのベースURLから成ります。その最後に /webservice/rest/server.php?wsfunction=module_lti_launch が追加されています。

    注釈

    「ツールURL」 フィールドを使用することもできますが、MaharaのウェブサービスはSSL経由でしか動作しないため(開発者インスタンスがない限り)、 「セキュアツールURL」 を選択することをお勧めします。

  5. コンテナを起動する: 「新規ウィンドウ」 または 「既存ウィンドウ」 を選択します。Maharaを埋め込むことを選択しないでください。あなたが他のウェブサイトにMaharaを埋め込むことは許されていないので、それは機能しません。さらに、それはあなたがMaharaで作業できるスペースを減らすでしょう。

  6. コンシューマキー: 前にあなたが設定したLTI接続のためにMaharaからコンシューマキーを貼り付けます。

  7. 共有秘密鍵: 前にあなたが設定したLTI接続のためにMaharaからコンシューマ秘密鍵を貼り付けます。

  8. セキュアなアイコンURL: 外部ツール用の標準のMoodleアイコンを表示したくない場合は、お気に入りのアイコンへのリンクを提供できます。Maharaサイトにいて、最良の結果を得るためにMoodleが必要とするサイズを提供することをお勧めします。

  9. 保存してコースに戻る ボタンをクリックしてコースページに戻り、保存して表示する ボタンをクリックしてMaharaにすぐにアクセスするか、キャンセル ボタンをクリックしてコースに活動として追加します。

注釈

ページ上の他の設定を変更する必要はありません。

12.5. Blackboardでの設定

Blackboardのビルトイン 「Basic LTI Tools」 を使ってLTI経由でMaharaへの接続を設定できます。

12.5.1. サイトのLTIを設定する

コースでLTIツールを追加できるようにするには管理者がLTIツールを設定する必要があります。

12.5.1.1. ビルディングブロックを設定する

Choose to set up an LTI tool

LTIツールの設定を選択する

ビルディングブロック エリアにいるときは、LTIツールプロバイダ を選択してMaharaへの接続を設定します。

次の画面で プロバイダドメインを登録する ボタンをクリックします。

Register the LTI provider

LTIプロバイダを登録する

  1. プロバイダドメイン: あなたのMaharaサイトのURLを入力してください。

  2. プロバイダドメインステータス: あなたがLTI接続を使用したい場合、 「承認済み」を選択する必要があります。

  3. デフォルト設定: コースでLTIを使用するか、グローバルに設定するインスタンスごとに個別の設定を提供するか決定できます。

    • リンクごとに個別に設定: 一つのMaharaインスタンス内の異なるインスティテューションに接続する場合は、このオプションを使用します。LTIビルディングブロックをコースに追加するたびに、コンシューマキーと秘密鍵情報を提供する必要があることに注意してください。

    • グローバルに設定: すべての人がMaharaの同じインスティテューションに入場するときにこのオプションを使用します。Maharaへのリンクがここに設定されているようにコースに追加されたときに、コンシューマキーと秘密鍵を提供する必要はありません。

  4. ツールプロバイダキー: 前に設定したLTI接続用のMaharaのコンシューマキーを貼り付けます。

  5. ツールプロバイダ秘密鍵: 以前に設定したLTI接続のMaharaからのコンシューマ秘密鍵を貼り付けます。

  6. ツールプロバイダのカスタマイズされたパラメータ: 次のパラメータを入力します: wsfunction=module_lti_launch

  7. ユーザデータの送信: ユーザデータをMaharaに送信する方法を決定します:

    • Never: ユーザデータは送信されません。

    • SSLを介してだけユーザデータを送信する: ユーザデータが暗号化されて送信されます。このオプションは、本番サイトで推奨されるオプションです。Maharaのウェブサービスでは、プロダクションモード でないサイトに接続していない限り、SSL接続が確立されている必要があります。

    • 任意の接続でユーザデータを送信する: MaharaのウェブサービスはプロダクションモードでSSL接続が必要なため、このオプションを選択できます。このオプションは、テストインスタンスがSSL証明書を持っていない可能性があるため、テスト目的に役立ちます。

  8. 送信するユーザフィールド: どのユーザフィールドをMaharaに送信するかを選択します。

    • コースのロール: 現在、Maharaはこのフィールドを無視しています。

    • 名前: 名(first name)と姓(last name)がMaharaに送信されます。

    • メールアドレス*: LTIリンクをクリックした人のメールアドレスがMaharaに送信されます。

  9. ユーザ確認メッセージを表示する: リンクをクリックした場合、Maharaで設定されていることを確認できます。これはログイン時に特別なメッセージを提供したい場合に便利です。

  10. メッセージテキスト: 「ユーザ確認メッセージ」 のテキストを入力します。

  11. 送信 ボタンをクリックして続行するか、キャンセル ボタンをクリックして変更を中止します。

12.5.1.2. ビルディングブロックの配置を管理する

Manage the placement of the LTI connection

LTI接続の配置を管理する

LTIツールプロバイダ画面に戻るときは、MaharaのURLを右クリックし、配置を管理する を選択してコースの配置を作成します。次の画面で、配置の作成リンクをクリックします。

Create a placement for the LTI connection

LTI接続の配置を作成する

  1. ラベル: コースに学生と教師に表示される名前を付けます。

  2. 説明: 接続の説明を入力できます。

  3. ハンドル: 配置に一意の名前を付けます。コースナビゲーションには表示されません。

  4. 利用可能: 配置を利用可能にするかどうかを選択します。 「No」 を選択すると配置の準備はできますが、学生はそれを見ることはできません。

  5. タイプ: タイプは、学生がどのようにツールと対話できるかを決定します。 「コンテンツタイプ」 を選択し、 「ツール」 オプションを選択します。

  6. アイコン: あなたは配置を簡単に識別する目的でカスタムアイコンをアップロードできます。アイコンサイズは50 x 50ピクセルにしてください。

  7. ツールプロバイダのURL: MaharaサイトのURLを入力します。

  8. ツールプロバイダキー: 前に設定したLTI接続用のMaharaのコンシューマキーを貼り付けます。

  9. ツールプロバイダ秘密鍵: 以前に設定したLTI接続のMaharaからのコンシューマ秘密鍵を貼り付けます。

  10. ツールプロバイダのカスタマイズされたパラメータ: 次のパラメータを入力します: wsfunction=module_lti_launch

  11. 送信 ボタンをクリックして続行するか、キャンセル ボタンをクリックして変更を中止します。

12.5.1.3. 配置をコースに追加する

Select the placement in your course

あなたのコースの配置を選択する

  1. コースナビゲーションの 「Mahara」 の配置をクリックします。

  2. ツール ボタンをクリックしてください。

  3. Mahara LTIツールを選択します。注:ここに表示されている名前とは異なる名前を付けている可能性があります。

Finalize the settings for the course link

コースリンクの設定を完了する

  1. 名前: あなたが別の名前を表示したい場合、デフォルトの名前を変更できます。

  2. 色の名前: コースのリンク色を選択してください。

  3. 説明: そのようなあなたがコースで学生と教師に表示された場合の説明を入力します。

  4. ユーザがこのコンテンツを見ることを許可する: 学生と教師がコースのリンクを見ることができるかどうかを決定します。

  5. 閲覧回数を追跡する: レポートにリンクのクリックを含めるかどうかを決定します。

  6. 日付および時刻制限を選択する: 特定の時刻にリンクを自動的に使用できるようにするには日付および時刻を入力してください。

  7. 送信 ボタンをクリックして続行するか、キャンセル ボタンをクリックして変更を中止します。

  8. あなたのリンクが使用できるようになりました。コースの学生および教師はリンクを介してMaharaにログインできます。