In the Connections agenda we keep records of the links between the portal and other systems. Each connection is a record by which we allow an external system to log its users in to the portal and to work with its content. The agenda is ready for different types of connections; at present it offers one — Moodle. We open it from the menu with Portal administration → Connections.
This article describes the screen itself. What the individual options of a Moodle connection mean, how the other side is set up and how the integration works is explained in the article Moodle integration.
The list of connections
The table shows the ID, the type of connection, the allowed domains, the shared key, the properties and the note; clicking a column header sorts the list. With the icon
next to the shared key we copy it to the clipboard. The Properties column summarises the state of the connection with badges:
- Active / Inactive — an external system cannot log in to the portal through an inactive connection;
- Creates users (with the name of the role assigned) / Only verifies users;
- New signature only / Old signature too — a yellow badge warns that the connection still accepts the older signature format;
- the date the connection was created.
A new connection and editing it
With the New connection button we open the dialog for creating one; with the Edit button in the row we open a dialog with the same fields for making changes:
- Connection type — for now always Moodle; the field cannot be changed;
- Allowed domains — the domains from which the connected system may access the portal; we separate several domains with a comma;
- Shared key — a secret string shared by both sides; the administrator of the connected system enters the same one;
- Active — switches the connection on and off without deleting it;
- Moodle is authoritative for user management and Role of new users — whether the connection may create users itself, and with which role. This pair is shown only if the platform administrator has allowed it for the platform;
- Require the new signature format — accepts only the newer, more secure signing of requests;
- Note — for our own orientation, for example which installation it is.
Deleting
With the Delete button we remove the connection after confirmation; the connected system then cannot log in to the portal. If we only want to interrupt the connection temporarily, it is enough to switch off Active.