Translations by Masayuki Kuwada

You can use :ref:`web services <webservices>` and authentication methods to connect other applications to Mahara. Depending on the type of integration you are seeking, you may be able to simply set the connection up in Mahara itself. In other cases, some development work may be needed.

Choose the institution in which you want to set up the application.

Click the *Manage* button |manage| if you want to see more options and make a decision on them.

.. image:: images/administration/external/lti_parent.* :alt: Set a parent authentication method for LTI

.. image:: images/administration/external/canvas_select_eac.* :alt: Choose Mahara from the Edu App Center

.. image:: images/administration/external/canvas_eac_configuration.* :alt: Configure Mahara via the Edu App Center

If you already have an account in the institution in Mahara with the email address you use in Canvas, you are taken to that account.

.. image:: images/administration/external/canvas_select_manual.* :alt: Choose to set up Mahara manually

.. image:: images/administration/external/canvas_manual_configuration_enter.* :alt: Make changes to the LTI setup

.. image:: images/administration/external/canvas_manual_configuration_edit.* :alt: Edit the LTI configuration in Canvas

**Shared Secret**: That is the "Consumer secret" on Mahara. If it has changed, update it here.

You can set up Mahara in two different ways for use in Moodle:

.. image:: images/administration/external/moodle_external_tool_configuration.* :alt: Configure Moodle to connect to Mahara

**Tool URL**: Provide the launch URL. It consists of the base URL of your Mahara site and the following added to the end of it: ``/webservice/rest/server.php?wsfunction=module_lti_launch``

**Tool description**: This field is optional. Providing a description will help your teachers to identify the tool more easily.

**Secure icon URL**: If you don't want to display the regular Moodle icon for external tools, you can provide a link to your favorite icon. It is recommended that you provide one that sits on your Mahara site and has the dimensions needed by Moodle for best results.

.. image:: images/administration/external/moodle_external_tool_preconfigured.* :alt: Choose a preconfigured Mahara instance in Moodle

.. image:: images/administration/external/moodle_external_tool_course_setup.* :alt: Set up Mahara as external tool in a Moodle course

**Activity description**: Provide a description of your activity. This field is optional.

**Secure tool URL**: Provide the launch URL. It consists of the base URL of your Mahara site and the following added to the end of it: ``/webservice/rest/server.php?wsfunction=module_lti_launch``

.. image:: images/administration/external/blackboard_building_block_selector.* :alt: Choose to set up an LTI tool

On the next screen, click the *Register Provider Domain* button.

**Provider Domain**: Enter the URL of your Mahara site.

**Set separately for each link**: Use this option if you want to connect to different institutions in one Mahara instance. Note that you will need to provide the consumer key and secret each time you want to add an LTI building block to a course.

**Set globally**: Use this option when everyone shall enter the same institution in Mahara. You do not need to provide the consumer key and secret when a link to Mahara is added in a course as it is set here.

.. image:: images/administration/external/blackboard_select_manage_placements.* :alt: Manage the placement of the LTI connection

.. image:: images/administration/external/blackboard_create_placement.* :alt: Create a placement for the LTI connection

**Tool Provider URL**: Enter the URL of your Mahara site.

.. image:: images/administration/external/blackboard_course_select_tool.* :alt: Select the placement in your course

.. image:: images/administration/external/blackboard_course_create_link.* :alt: Finalize the settings for the course link

.. image:: images/administration/external/canvas_assignment_add.* :alt: Add an assignment to your Canvas course

.. image:: images/administration/external/canvas_assignment_setup.* :alt: Assignment settings for your LTI activity