This works only if your Moodle administrator has set up the connection. If you don't see Switch Drive in Moodle, ask your Moodle help desk.

1. In Moodle, open the File picker. Choose Switch Drive on the left.
2. Sign in to your Switch Drive account.
3. Select the file you want to use.
4. Choose how Moodle should use it:
   • Make a copy of the file. Moodle gets its own copy. Later changes in Switch Drive are not passed on.
   • Create an alias / shortcut to the file. The file stays in Switch Drive. When you change it, Moodle shows the new version.
   • Create an access controlled link to the file. Useful when students hand in work. Once handed in, the file is locked until you release it.
5. Click Select this file.

Preparation

1. Find your Moodle's OAuth2 callback URL. It looks like https://yourmoodle/admin/oauth2callback.php.
2. Email drive-support@switch.ch and say you want to connect Moodle to Switch Drive. Attach the callback URL.
3. Switch creates a client ID and a secret key and sends them to you in a file.

Configuration in Moodle

1. Open the ownCloud repository plugin and set it to Enabled and visible. The plugin also works with Nextcloud.
2. Go to Site administration > Server > OAuth2 services and click Create a new custom service.
   • Choose a name. Users don't see it.
   • Enter the client ID and the secret key from Switch. Switch on Authenticate token requests via HTTP headers.
   • Set the service base URL to https://drive.switch.ch/.
   • Save.
3. Back in the repository settings, click Create a repository instance.
4. Choose a name that users will see. Select the service you just created in the Issuer list.
5. Open the configuration (gear icon) and enter the mappings. Then open the user configuration and check the settings. [Mappings and settings: copy from the original page, they are shown as screenshots there.]
6. Test the connection in a Moodle course.

A voucher is a secret, one-time link. Whoever opens it can create a full Switch Drive account with their own storage. It is linked to you as the creator and to the person who activates it.

Why use one? Your external project partners then don't need public links. They can use the Sync Client, so project files stay automatically up to date, without error-prone manual uploads and downloads.

How do I get one? Ask your institution's administrator. See whether your institution allows vouchers and how to request them. You can also ask for a voucher to be deleted when your partner no longer needs access.

After activation: your partner appears in the Switch Drive address book. To share, type their name in the sharing box and choose the entry with (eduid) behind the name.

Welcome to Switch Drive! Follow these steps:

1. Create a Switch edu-ID if you don't have one yet: https://eduid.ch/web/registration. You most likely don't have an AAI account, so choose manual registration. Forgot your password? Use https://eduid.ch/web/reset-password.
2. Remember your email address and password. You need them to sign in. You can add more email addresses and use any of them to sign in. Your primary email address receives notifications from Switch Drive.
3. Open the voucher link. Accept the terms and conditions, then click Register for Switch Drive.
4. Sign in at https://drive.switch.ch, or click Go to Switch Drive.

More details: How to register Switch Drive.

Project Folders come with their own storage, so you have to apply at your institution. You may be asked for the planned size, the purpose of the project and a list of project members.

Contact your local Switch Drive administrator. How to proceed.