https://mediawiki.middlebury.edu/LIS/api.php?action=feedcontributions&user=Adam+Franco&feedformat=atomLibrary & ITS Wiki - User contributions [en]2024-03-19T01:46:38ZUser contributionsMediaWiki 1.35.14https://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_8_Updates&diff=42360Drupal 8 Updates2023-01-24T20:47:37Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div><br />
Moved to [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=563 TDX Knowledge Base]<br />
<br />
[[Category:Drupal]] [[Category:Web Application Development]] [[Category:Drupal 8]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=WordPress_Development&diff=42359WordPress Development2023-01-24T20:43:00Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div>Moved to [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=562 TDX]<br />
<br />
[[Category:WordPress]]<br />
[[Category:Web Application Development]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=WordPress_Administration&diff=42358WordPress Administration2023-01-24T20:42:36Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div>Moved to [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=562 TDX]<br />
<br />
[[Category:WordPress]]<br />
[[Category:Web Application Development]]<br />
[[Category:TDXNO]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=WordPress_plugin_requests&diff=42357WordPress plugin requests2023-01-24T20:31:37Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div><br />
Moved to the [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=561 TDX Knowledge Base]<br />
<br />
[[Category:WordPress]]<br />
[[Category:TDXKB]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=WordPress_Plugins&diff=42356WordPress Plugins2023-01-24T20:21:51Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div>Moved to the [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=560 TDX Knowledge base]<br />
<br />
[[Category:Public Search]]<br />
[[Category:WordPress]]<br />
[[Category:TDXKB]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=WordPress&diff=42355WordPress2023-01-24T20:12:38Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div>Moved to the [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=559 TDX Knowledge base]<br />
[[Category:WordPress]] [[Category:Export]] [[Category:Category:Public Search]] [[Category:Web-Content Platforms]] [[Category:Educational Technology]] [[Category:Software]] [[Category:Web Application Development]]<br />
[[Category:TDXKB]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CAS_Administration&diff=42354CAS Administration2023-01-24T19:36:26Z<p>Adam Franco: moved to TDX</p>
<hr />
<div>Content has been moved to: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=557<br />
<br />
[[Category:Web Application Development]]<br />
[[Category:CAS]]<br />
[[Category:TDXKB]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CAS_Directory&diff=42353CAS Directory2023-01-24T19:35:24Z<p>Adam Franco: </p>
<hr />
<div>Moved to https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=558<br />
<br />
[[Category:CAS]]<br />
[[Category:Web Application Development]]<br />
[[Category:TDXKB]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CAS_Directory&diff=42352CAS Directory2023-01-24T19:35:05Z<p>Adam Franco: Replaced content with "Moved to https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=558 Category:CAS Category:Web Application Development"</p>
<hr />
<div>Moved to https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=558<br />
<br />
[[Category:CAS]]<br />
[[Category:Web Application Development]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CAS&diff=42351CAS2023-01-24T19:23:48Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div>Moved to the [https://support.gmhec.org/TDClient/47/middlebury/KB/Edit?ID=556 TDX Knowledge base]<br />
[[Category:Web Application Development]]<br />
[[Category:CAS]]<br />
[[Category:TDXKB]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CourseHub_name_pronunciation&diff=42350CourseHub name pronunciation2023-01-23T20:33:07Z<p>Adam Franco: Moved to TDX</p>
<hr />
<div>Moved to https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=555<br />
<br />
[[Category:CourseHub]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=File:Hub_instructor_view-authenticated.png&diff=42349File:Hub instructor view-authenticated.png2023-01-23T20:32:38Z<p>Adam Franco: </p>
<hr />
<div>Moved to https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=555<br />
<br />
[[Category:CourseHub]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Course_Catalog_Help&diff=42348Course Catalog Help2023-01-23T20:09:43Z<p>Adam Franco: Move to TDX knowledge base</p>
<hr />
<div>Documentation on the Course Catalog now lives in TDX: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=553<br />
<br />
[[Category:Course Catalog]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Course_Catalog&diff=42347Course Catalog2023-01-23T20:08:44Z<p>Adam Franco: Remove old content</p>
<hr />
<div>The previous version of this page can be found at https://web.archive.org/web/20230000000000*/https://mediawiki.middlebury.edu/LIS/Course_Catalog<br />
<br />
Documentation on the Course Catalog now lives in TDX: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=553<br />
<br />
[[Category:Course Catalog]]<br />
[[Category:Web Application Development]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CourseHub&diff=41422CourseHub2022-08-09T15:29:38Z<p>Adam Franco: </p>
<hr />
<div>This article has been moved to [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=329 TDX Knowledge Base: Course Hub]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CourseHub&diff=41421CourseHub2022-08-09T15:28:41Z<p>Adam Franco: Remove extra tags</p>
<hr />
<div>#REDIRECT [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=329 TDX Knowledge Base: Course Hub]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CourseHub&diff=41420CourseHub2022-08-09T15:28:07Z<p>Adam Franco: Move to TDX knowledge base</p>
<hr />
<div>#REDIRECT [https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=329 TDX Knowledge Base: Course Hub]<br />
<br />
[[Category:Public Search]]<br />
[[Category:Public LIS Documentation]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_8_Updates&diff=41013Drupal 8 Updates2021-12-13T21:34:21Z<p>Adam Franco: /* Updating Core */ Add helper script for core upgrades.</p>
<hr />
<div><br />
Before doing updates, you will need to follow the Drupal 8 Development Site Installation guide.<br />
<br />
== Exclusions ==<br />
<br />
*varnish_purge: The [https://www.drupal.org/node/2843978 patch to allow multiple IPs] does not apply cleanly on version 8.x-1.12. <br />
*workbench_access: [https://www.drupal.org/project/workbench_access/issues/3125798 Issue in 8.x-1.0-beta3] shows a PHP warnings to users. <br />
<br />
== Versions ==<br />
<br />
Composer allows us to peg modules and dependencies at specific versions. We do this to ensure that updates are not applied unless we specifically request them. These are common formats for versions of Drupal core and its modules.<br />
<br />
=== Tagged Release ===<br />
<br />
Core release 8.5.3 = composer require --no-update drupal/core:8.5.3<br />
<br />
Module anchor_link release 8.x-1.6 = composer require --no-update drupal/anchor_link:1.6<br />
<br />
Module twig_tweak 8.x-2.0 = composer require --no-update drupal/twig_tweak:2.0<br />
<br />
=== Alpha / Beta / RC Releases ===<br />
<br />
Module block_field 8.x-1.0-alpha5 = composer require --no-update drupal/block_field:1.0-alpha5<br />
<br />
Module media_entity_audio 8.x-1.0-beta3 = composer require --no-update drupal/media_entity_audio:1.0-beta3<br />
<br />
Module diff 8.x-1.0-rc1 = composer require --no-update drupal/diff:1.0-rc1<br />
<br />
=== Development Releases ===<br />
<br />
Generally, we want to avoid pegging to a development release, however this is sometimes necessary if we need to apply a patch which will only apply cleanly to the dev branch or if a module maintainer has committed a critical patch, but has not released a stable tagged release. Whenever we use a dev release, we should get the hash of the commit we've tested against and include it in the composer requirements. This prevents composer from downloading commits past that hash.<br />
<br />
Module olark 8.x-1.x-dev = compooser require --no-update drupal/olark:1.x-dev#940ab50528b683c12ca6208daec06d38899b883a<br />
<br />
Module token_language 8.x-1.x-dev = composer require --no-update drupal/token_language:1.x-dev#489c8ca30d165b6aaeba3e5dc65bd17b967a8b54<br />
<br />
&nbsp;<br />
<br />
== Adding Modules ==<br />
<br />
#Adding module via composer involves first telling composer to add the module to composer.json while not performing other updates:<br/> <br/> composer require --no-update drupal/MODULE_NAME:VERSION<br/> &nbsp; <br />
#Next we tell composer to rebuild the composer.lock file with any dependencies, and install the odule and its dependencies:<br/> <br/> composer update --with-dependencies nothing <br />
<br />
Running "composer install" will install everything listed in the composer.lock file and not make any updates to it or the composer.json. This is useful after a "git pull" to install any new dependencies.<br />
<br />
&nbsp;<br />
<br />
== Updating Modules ==<br />
<br />
#Go to [https://www.middlebury.edu/institute/admin/reports/updates https://www.middlebury.edu/institute/admin/reports/updates] and click on Check Manually to fetch the latest version information. The settings on the Institute site are configured to check for all modules, including those disabled on the site. <br />
#cd ~/private_html/institute <br />
#git pull <br />
#For each module: <br />
##composer require --update-with-dependencies drupal/MODULE_NAME:VERSION (see the Versions section above) <br />
##If you receive as error such as: "Could not apply patch! Skipping." <br />
###Check the module's dev log to see if the named patch was incorporated into the new release <br />
###If so, you can remove the patch from composer.json and run composer require again. <br />
##Check to ensure that only the module and composer files were changed using git status. <br />
##Check whether the module updates require database schema changes by running "drush8 updatedb". If they do: <br />
###Create a new branch to test the module updates, based on the master branch. <br />
####git checkout --track -b updates-20180601-MODULE_NAME <br />
####git push -u origin updates-20180601-MODULE_NAME <br />
####Follow steps 5-7 below but do not merge this into master. Update the scheduled downtime notes to reflect that you will deploy this change during the next Thursday downtime window. <br />
##git add composer.* <br />
##git add -A web/modules/contrib/MODULE_NAME <br />
##git commit -m "MODULE_NAME: Upgraded module from OLD_VERSION to NEW_VERSION. For #NNN." <br />
###"NNN" is the number of the issue in Github for updating the modules this week. <br />
##Update the Weekly Updates Post with "Drupal MODULE_NAME NEW_VERSION" linking to the releases page on drupal.org. <br />
#git checkout master <br />
#git merge --no-ff -m "Fix #NNN updates." updates-20180601 <br />
#git push <br />
#Follow the Drupal 8 Deployment process. Make sure to use the -c flag. <br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
== Updating Core ==<br />
Steps 2-4 below can now be handled by the [https://github.com/middlebury/drupal9-drush-scripts/blob/main/upgrade-drupal-core.sh drupal9-drush-scripts/upgrade-drupal-core.sh] command:<pre>cd ~/private_html/institute<br />
../drupal9-drush-scripts/upgrade-drupal-core.sh 9.3.0<br />
git status<br />
git add -A<br />
git commit -m "drupal: Upgraded core from OLD_VERSION to NEW_VERSION."</pre>1. Change to your D8 directory.<br />
<pre>cd ~/private_html/institute</pre><br />
<br />
2. Require new versions of the core composer packages (see the Versions section above):<br />
<pre>composer require --no-update drupal/core:VERSION<br />
composer require --no-update drupal/core-composer-scaffold:VERSION<br />
composer require --no-update drupal/core-project-message:VERSION<br />
composer require --no-update drupal/core-recommended:VERSION<br />
composer require --dev --no-update drupal/core-dev:VERSION</pre><br />
<br />
3. Download required versions and update the lock file:<br />
<pre>composer update --with-dependencies drupal/core drupal/core-composer-scaffold drupal/core-project-message drupal/core-recommended drupal/core-dev</pre><br />
<br />
4. ''Not sure if this is needed...''<br />
<pre>composer update nothing</pre><br />
<br />
5. Stage and commit the changes.<br />
<pre>git add -A<br />
git commit -m "drupal: Upgraded core from OLD_VERSION to NEW_VERSION."</pre><br />
<br />
7. Check whether the core update requires database schema changes:<br />
<pre>drush8 updatedb</pre><br />
<br />
8. Push changes<br />
<pre>git push</pre><br />
<br />
9. Ensure that any config changes made by the updates get retained (in all sites), by running the database updates, exporting config, and committing changes for each site...<br />
<pre>drush8 updatedb<br />
drush8 cex<br />
git add config/<br />
git commit -m "SITENAME: Update config for core update to NEW_VERSION."</pre><br />
<br />
10. Follow the Drupal 8 Deployment process. Make sure to use the -c flag.<br />
<br />
== Troubleshooting Composer ==<br />
<br />
If composer is not able to find any updates (this will often happen with alpha and beta releases), use this command to check to see if it is being blocked by dependency version requirements:<br />
<br />
composer why drupal/MODULE_NAME<br />
<br />
Another way to find out what's blocking things is `composer prohibits`:<br />
<pre style="margin: 10px 0px 0px; padding: 0px; color: rgb(9, 30, 66); font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial">$ composer prohibits drupal/core 8.7.0<br />
webflo/drupal-core-require-dev 8.6.15 requires drupal/core (8.6.15) <br />
drupal/core 8.7.0 requires symfony/http-foundation (~3.4.27) <br />
middlebury/drupal8 dev-master does not require symfony/http-foundation (but v3.4.26 is installed) <br />
drupal/core 8.7.0 requires egulias/email-validator (^2.0) <br />
middlebury/drupal8 dev-master requires egulias/email-validator (^1.2)</pre><br />
<br />
You may need to explicitly tell composer to update that package:<br />
<br />
composer update drupal/core webflo/drupal-core-require-dev symfony/http-foundation egulias/email-validator --with-dependencies<br />
<br />
If it is still unclear why composer is running into conflicts, it is generally safe to blow away the composer cache and vendor/ directory and reinstall dependencies fresh:<br />
<pre style="margin: 10px 0px 0px; padding: 0px; color: rgb(9, 30, 66); font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial">rm -Rf vendor/*<br />
composer clear-cache<br />
<code style="font-family: monospace">composer update drupal/core&nbsp;webflo/drupal-core-require-dev --with-dependencies</code></pre><br />
<br />
[[Category:Drupal]] [[Category:Web Application Development]] [[Category:Drupal 8]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40806GitHub2021-07-16T19:05:46Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This is draft documentation. We are looking for feedback from instructors who have used GitHub and GitHub Classroom in their courses to validate this process. Please contact us via a HelpDesk Ticket if you are using this service or interested in piloting it in a course.}}<br />
<br />
&nbsp;<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Education] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= For Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are available at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= For Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
Organizations in Github are collaboration spaces that contain teams and repositories. Any GitHub user account can be invited to collaborate in a team or repository in an organization.<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficient. Organizations created in the free-tier are associated with your GitHub user account and you will keep ownership of them when you leave Middlebury.<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and additional minutes of processing for automation actions.<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be administrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the administrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
Enterprise-tier organizations are associated with the Middlebury Enterprise and ITS can update/replace organization-owners as needed. There is no way to convert an organization from an Enterprise-tier to a free-tier if you leave Middlebury however individual repositories can be migrated to different organizations.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assignment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assignments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assignment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
= Additional Resources =<br />
<br />
*[https://docs.github.com/en/education GitHub Education documentation] <br />
*[https://education.github.community/ GitHub Education community] <br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40805GitHub2021-07-16T18:21:39Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This is draft documentation. We are looking for feedback from instructors who have used GitHub and GitHub Classroom in their courses to validate this process. Please contact us via a HelpDesk Ticket if you are using this service or interested in piloting it in a course.}}<br />
<br />
&nbsp;<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Education] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= For Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are available at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= For Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficient.<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and additional minutes of processing for automation actions.<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be administrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the administrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assignment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assignments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assignment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
= Additional Resources =<br />
<br />
*[https://docs.github.com/en/education GitHub Education documentation] <br />
*[https://education.github.community/ GitHub Education community] <br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40761GitHub2021-07-01T20:53:16Z<p>Adam Franco: Add community link</p>
<hr />
<div><br />
{{note|This is draft documentation. We are looking for feedback from instructors who have used GitHub and GitHub Classroom in their courses to validate this process. Please contact us via a HelpDesk Ticket if you are using this service or interested in piloting it in a course.}}<br />
<br />
&nbsp;<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= For Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are available at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= For Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficient.<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and additional minutes of processing for automation actions.<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be administrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the administrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assignment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assignments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assignment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
= Additional Resources =<br />
<br />
*[https://docs.github.com/en/education GitHub Education documentation] <br />
*[https://education.github.community/ GitHub Education community] <br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40760GitHub2021-07-01T20:44:20Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This is draft documentation. We are looking for feedback from instructors who have used GitHub and GitHub Classroom in their courses to validate this process. Please contact us via a HelpDesk Ticket if you are using this service or interested in piloting it in a course.}}<br />
<br />
&nbsp;<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= For Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are available at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= For Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficient.<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and additional minutes of processing for automation actions.<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be administrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the administrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assignment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assignments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assignment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40759GitHub2021-07-01T20:42:22Z<p>Adam Franco: Add note</p>
<hr />
<div><br />
{{Note|This is draft documentation. We are looking for feedback from instructors who have used GitHub and GitHub Classroom in their courses to validate this process. Please contact us via a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] if you are using this service or interested in piloting it in a course.}}<br />
<br />
&nbsp;<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= For Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are available at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= For Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficient.<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and additional minutes of processing for automation actions.<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be administrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the administrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assignment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assignments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assignment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40758GitHub2021-07-01T20:37:15Z<p>Adam Franco: Minor typos and formatting</p>
<hr />
<div><br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= For Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are available at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= For Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficient.<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and additional minutes of processing for automation actions. <br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be administrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the administrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assignment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assignments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assignment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40757GitHub2021-07-01T20:32:42Z<p>Adam Franco: More info on free vs enterprise tier.</p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
&nbsp;<br />
<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
While free-tier Organizations can have unlimited collaborators and private repositories, "Enterprise" organizations get additional storage and minutes of processing for automation actions.<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assigments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assigment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40756GitHub2021-07-01T20:16:01Z<p>Adam Franco: Clarify roster usage.</p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
&nbsp;<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
&nbsp;<br />
<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment.<br />
<br />
It is not necessary to create a roster for the class -- student GitHub accounts will be simply listed as "unlinked" when they access assigments. At this time we don't have an integration set up with Canvas or other services, so if you would like to list students in a roster with their real names (rather than GitHub usernames), add their names to the roster -- one per line. Students will have the option to self-associate their GitHub accounts with their roster entry on assigment acceptance. If they choose the wrong student roster entry you can unlink and relink them in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40753GitHub2021-07-01T14:17:09Z<p>Adam Franco: Add WebHelpdesk links</p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
&nbsp;<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk Ticket] with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
&nbsp;<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=443 HelpDesk ticket] so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relink them in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40752GitHub2021-06-30T21:22:36Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox [1]] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relink them in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40751GitHub2021-06-30T21:22:16Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox [1]] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relinkthem in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40750GitHub2021-06-30T21:21:39Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox [1]] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ classroom.github.com]. You will want to associate the Classroom with your @middlebury.edu email address. If you'd like an "Enterprise"-tier Organization in the "Middlebury College" Enterprise, please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with. Once we've created the Organization for you, you will be able to select it when creating "Classrooms".<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relinkthem in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40749GitHub2021-06-30T21:19:25Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox [1]] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
=== Free-tier Organizations ===<br />
<br />
You are welcome to self-service create free-tier "Organizations" in GitHub that aren't associated with the "Middlebury College" Enterprise subscription. See [https://github.com/organizations/plan] for details. For many purposes the free tier may be sufficent<br />
<br />
=== Enterprise-tier Organizations ===<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise" subscription. Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ [2]]. You will want to associate the Classroom with your @middlebury.edu email address and the "Middlebury College" Enterprise. Please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with.<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relinkthem in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40748GitHub2021-06-30T21:06:22Z<p>Adam Franco: </p>
<hr />
<div><br />
{{note|This page is a draft in progress.}}<br />
<br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox [1]] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise". Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ [2]]. You will want to associate the Classroom with your @middlebury.edu email address and the "Middlebury College" Enterprise. Please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with.<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relinkthem in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40747GitHub2021-06-30T20:56:46Z<p>Adam Franco: </p>
<hr />
<div><br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox [1]] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise". Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/ [2]]. You will want to associate the Classroom with your @middlebury.edu email address and the "Middlebury College" Enterprise. Please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with.<br />
<br />
Once you create the Classroom you can add Assignments to it and send students an invite to that Assigment. If you've added student-ids to a roster students will have the option to self-associate their GitHub accounts with their roster-id on assigment acceptance. If they choose the wrong student ID you can unlink and relinkthem in the Classroom's roster page.<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=40746GitHub2021-06-30T20:54:08Z<p>Adam Franco: Initial docs</p>
<hr />
<div><br />
Middlebury has subscribed to the [https://education.github.com/ GitHub Eduction] Campus Program which provides GitHub's software development and version control tools for students and instructors.<br />
<br />
= Students =<br />
<br />
== GitHub Student Developer Pack ==<br />
<br />
Students can get access the [https://education.github.com/pack GitHub Student Developer Pack] by creating a GitHub account and adding your @middlebury.edu email address and verifying it. Full instructions are availble at [https://docs.github.com/en/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/apply-for-a-student-developer-pack GitHub Docs: Apply for a student developer pack].<br />
<br />
While most of GitHub's own service will be free for students to use, the Developer Pack provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
= Instructors =<br />
<br />
== GitHub Teacher Toolbox ==<br />
<br />
Similar to the Student Developer Pack (above), the Teacher Toolbox provides free or discounted access to many continuous integration, testing, and hosting tools.<br />
<br />
Create a GitHub account if you don't already have one and then associate your @middlebury.edu email address with that account and verify it. Once you've verified your @middlebury.edu email address you can go to [https://education.github.com/toolbox] and click "Get the Toolbox". Be sure to choose your @middlebury.edu email address to associate the toolbox service.<br />
<br />
== GitHub "Organizations" for classes and research groups ==<br />
<br />
Middlebury's subscription to the GitHub Campus Program allows us to create virtually unlimited numbers of GitHub "Organizations" associated with our "Enterprise". Each organization has one or more administrators who can manage the settings and memberships of the Teams and Repositories associated with that Organization.<br />
<br />
There is currently no automation support, so if you would like a GitHub Organization for your class, project, or group, please submit a HelpDesk Ticket with the following information:<br />
<br />
*Which GitHub accounts should be adminstrators?<br/> Accounts must already have @middlebury.edu email addresses verified and must have enabled 2-factor authentication on their GitHub accounts. <br />
*What class, project, or group is this for? <br />
*Is this organization going to be used for just one semester or in an ongoing basis? <br />
<br />
ITS staff will create the GitHub Organization in our "Middlebury College" Enterprise account and make you the the adminstrator. You will then be responsible for inviting other collaborator or student accounts and managing Teams and Repositories in the Organization.<br />
<br />
== GitHub Classroom ==<br />
<br />
[https://classroom.github.com/ GitHub Classroom] is a tool that utilizes an "Organization" (above) and creates separate repositories for each student's work on assignments. For more information, see [https://docs.github.com/en/education/manage-coursework-with-github-classroom/get-started-with-github-classroom/basics-of-setting-up-github-classroom GitHub Docs: GitHub Classroom].<br />
<br />
New GitHub Classroom spaces can be created by going to [https://classroom.github.com/]. You will want to associate the Classroom with your @middlebury.edu email address and the "Middlebury College" Enterprise. Please submit a HelpDesk ticket so that ITS staff can create an Organization for you to use Classroom with.<br />
<br />
&nbsp;<br />
<br />
&nbsp;<br />
<br />
[[Category:Git]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=CAS&diff=40595CAS2021-03-14T15:37:56Z<p>Adam Franco: Update CAS CA certificate to InCommon CA cert from Digcert</p>
<hr />
<div>= About =<br />
<br />
Middlebury College uses the [http://www.jasig.org/cas Central Authentication Service (CAS)] developed by Yale and maintained by Jasig for single-sign-on to our suite of web-based applications.<br />
<br />
== Supported Protocols ==<br />
<br />
=== CAS 2.0 ===<br />
<br />
Our CAS server supports both standard and proxy-authentication via the [http://www.jasig.org/cas/protocol CAS 2.0 protocol]. The validation response is extended to include user attributes (see below). If your client application does not need proxy-authentication, it is recommended that you use the SAML protocol which includes user-attributes in a standard way.<br />
<br />
==== CAS 2.0 Protocol Extension: Attributes ====<br />
<br />
The [http://www.jasig.org/cas/protocol CAS 2.0 Protocol] deals only with returning a user-identifier on successful authentication and punts on returning any additional information about users. The general practice by many CAS implementers has been to fetch user attributes from an LDAP server based on the identifier returned by CAS. Many other institutions have found this practice to be unacceptable and have modified their CAS servers to return additional attributes with the user response, we are a member of the latter group.<br />
<br />
Our CAS server has been updated to return a number of <code>cas:attribute</code> elements alongside the <code>cas:user</code> identifier element. This allows applications to access commonly needed attributes such as group-membership, name, and email address without having to make additional requests from another system. Since virtually every client application that needs to authenticate users also needs to access these attributes, returning them in the CAS response eliminates a number of excess requests and allows applications to know about and rely on only one system.<br />
<br />
Unfortunately, many client applications do not natively support these additional attributes and need to be updated to use them. For PHP applications the [https://wiki.jasig.org/display/CASC/phpCAS phpCAS library] ('''version 1.2.0 and later''') supports the attribute format we return via its <code>phpCAS::getAttributes()</code> method. If your client application does not look for attributes in the CAS 2.0 response, it will need to be updated to call <code>phpCAS::getAttributes()</code> or a similar process in other environments. Another option is to use the SAML 2.0 protocol to authenticate rather than the CAS 2.0 protocol as the SAML 2.0 protocol includes attributes by default, so clients are more likely to expect to find them in the response.<br />
<br />
Finally, if it is not possible to update the CAS authentication module of an application or use the SAML 2.0 protocol, it is possible to fetch user-attributes from our LDAP servers with a few caveats:<br />
<br />
* You will need credentials for reading attributes out of the LDAP server<br />
* Because groups in our LDAP server (Active Directory) may be members of groups themselves, your application will need to manually traverse the group hierarchy in order to get a full list of groups. <br/>Example: A class-group does not directly have any members, but rather is a container for three groups (instructors, students, audits) that each directly contain members.<br />
* We may run multiple LDAP servers in the future to hold information on visitors and other constituent groups. At that time you may encounter users who can authenticate via CAS, but are not listed in our primary LDAP server.<br />
<br />
=== SAML ===<br />
Our CAS server supports both the [https://wiki.jasig.org/display/CASUM/SAML+1.1 SAML 1.1] and [https://wiki.jasig.org/display/CASUM/SAML+2.0+%28Google+Accounts+Integration%29 SAML 2.0] protocols.<br />
<br />
The SAML 1.1 protocol is recommended for all clients that require user attributes and that do not need proxy authentication.<br />
<br />
=== Single Sign Out ===<br />
At this time our CAS server does not support [https://wiki.jasig.org/display/CASUM/Single+Sign+Out Single Sign Out].<br />
<br />
= CASifying applications =<br />
<br />
In this section you will find instructions for adding CAS support to your web applications.<br />
<br />
*CAS is a service for providing ''authentication'', answering the question: Who is this person?<br />
*CAS does '''not''' provide ''authorization''. It does '''not''' answer the question: What can this person do?<br />
<br />
<br />
== General Configuration ==<br />
<br />
The following settings may be asked for when configuring applications to authenticate via CAS.<br />
<br />
*Host: login.middlebury.edu <br />
*Port: 443 <br />
*Path: /cas <br />
*CAS protocol version: 2.0 <br />
*Login URL: [https://login.middlebury.edu/cas/login https://login.middlebury.edu/cas/login] <br />
*Logout URL:&nbsp;[https://login.middlebury.edu/cas/logout https://login.middlebury.edu/cas/logout] <br />
*Service Validate URL: [https://login.middlebury.edu/cas/serviceValidate https://login.middlebury.edu/cas/serviceValidate] <br />
*Certificate Authority Certificate: [https://www.incommon.org/certificates/repository/sha384%20Intermediate%20cert.txt https://www.incommon.org/certificates/repository/sha384%20Intermediate%20cert.txt]<br />
<br />
== Data returned by CAS ==<br />
=== Valid assumptions ===<br />
<br />
Applications are free to make the following assumptions in relation to CAS.<br />
<br />
*'''User identifiers are unique''' - The identifier returned to an application from CAS will always uniquely identify a user.<br />
*'''User identifiers are un-changing''' - Changes in a user's status or name will not change their identifier.<br />
*'''The <code>MemberOf</code> (group membership attribute) is authoritative''' - Applications may use the <code>MemberOf</code> attribute to determine roles and authorizations. The values of this attribute are institutionally defined.<br />
<br />
=== Invalid assumptions ===<br />
<br />
Applications should '''not''' make the following assumptions in relation to CAS.<br />
<br />
*'''Authentication implying authorization''' - Authentication (and the receipt of a user id) does '''not''' imply that a user has any official status in relation to Middlebury College. Anyone can register for a [[Middlebury_Guest_Account]] that they can use to log in. Group-membership (<code>MemberOf</code> attribute) or a list of authorized ids should be checked to determine authorization within an application.<br><br />
*<span style="font-weight: bold;">The user identifier implying meaning</span> - Applications should treat the user identifier as an opaque string with up to 50 characters. No meaning should be inferred by the value of the identifier.<br><br />
*'''Additional attributes exist and have been verified''' - The <code>MemberOf</code> attribute can be trusted to be authoritative. All other attributes -- such as <code>FirstName</code>, <code>LastName</code>, <code>Email</code>, etc -- may or may not exist and may contain values self-submitted by visitors.<br />
<br />
=== Useful Groups ===<br />
<br />
Every application has its own needs for access and the roles that should be given for various users. Some applications are completely open to public usage, others authorize access to anyone officially associated with the institution, and still others restrict authorization to very limited groups of users. Applications should use the <code>MemberOf</code> attribute to determine membership in groups. Some groups will contain just users that are officially associated with the institution, others will contain just visitors, and still others will contain a mixture of both visitors and institutionally-associated users.<br />
<br />
For reference, here are some groups that applications may find useful for common cases:<br />
*<code>CN=institution,OU=General,OU=Groups,DC=middlebury,DC=edu</code> ''All officially associated Middlebury people, contains members of the groups below.''<br />
*<code>CN=All Staff,OU=General,OU=Groups,DC=middlebury,DC=edu</code><br />
*<code>CN=All Faculty,OU=General,OU=Groups,DC=middlebury,DC=edu</code><br />
*<code>CN=students,OU=Students_By_Year,OU=Groups,DC=middlebury,DC=edu</code><br />
*<code>CN=All LS People,OU=LS Lists,OU=Groups,DC=middlebury,DC=edu</code><br />
*<code>CN=All LS Faculty,OU=LS Lists,OU=Groups,DC=middlebury,DC=edu</code><br />
*<code>CN=MIIS Faculty,OU=Groups,DC=middlebury,DC=edu</code><br />
*<code>CN=MIIS Staff,OU=Groups,DC=middlebury,DC=edu</code><br />
<br />
=== <code></code>Example Authentication Response ===<br />
<br />
Below is an example response from the CAS&nbsp;server on successful authentication. Please note that the order of elements is arbitrary and that all of the valid and invalid assumptions above must be adheared to.<br><br />
<br />
Also note that the <code>cas:attribute</code> elements are non-standard additions to the response (though this addition is in wide use). CAS&nbsp;plugins for systems therefore may not know about attributes and may be expecting to do a subsequent LDAP&nbsp;lookup in order to fetch attributes.<br />
<pre>&lt;cas:serviceResponse xmlns:cas='http://www.yale.edu/tp/cas'&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:authenticationSuccess&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:user&gt;q234wd325253&lt;/cas:user&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="Login" value="jdoe"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="Status" value="Staff"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="EMail" value="jdoe@middlebury.edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="TelephoneNumber" value="802.443.2100"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="FirstName" value="John"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="Id" value="q234wd325253"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="LastName" value="Doe"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=DFS-LIS-Circulation Services,OU=DFS_Permissions,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=DFS-LIS-LISstaff,OU=DFS_Permissions,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=DFS-LIS,OU=DFS_Permissions,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=DFS Users,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=Student Org Advisors,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=webmkover-platform,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=LIS Liaisons,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=LIS Systems &amp; Infrastructure Cluster,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=district-lis,OU=Staff Districts,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=LIS Educational Services Group,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=All Staff,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=institution,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;cas:attribute name="MemberOf" value="CN=HEATUsers,OU=General,OU=Groups,DC=middlebury,DC=edu"/&gt;<br />
&nbsp;&nbsp;&nbsp;&nbsp;&lt;/cas:authenticationSuccess&gt;<br />
&lt;/cas:serviceResponse&gt;<br />
</pre><br />
<br><br />
<br />
== Adding CAS support to PHP applications ==<br />
<br />
The best way to enable your PHP application to authenticate against CAS is to use the [https://wiki.jasig.org/display/CASC/phpCAS phpCAS library] ('''version 1.2.0 or later''') and the methods contained therein.<br />
<br />
Additional documentation about the phpCAS&nbsp;library is available on the [http://www.ja-sig.org/wiki/display/CASC/phpCAS CAS&nbsp;wiki].<br />
<br />
=== Step by Step ===<br />
<br />
For web applications running on the development server anvil.middlebury.edu, you may skip steps 1 and 3. In this case, your include path in step 2 will be<br />
<pre>&lt;?php require_once "CAS.php";&nbsp;?&gt;</pre><br />
#[http://downloads.jasig.org/cas-clients/php/ Download] the latest version of the phpCAS library and unzip it where it can be accessed by your application code.<br />
#Include the phpCAS library in your code <pre>&lt;?php require_once "/path/to/phpCAS/source/CAS.php";&nbsp;?&gt;</pre><br />
#''Optional'' - Enable debug-mode for testing purposes: <pre>&lt;?php phpCAS::setDebug();&nbsp;?&gt;</pre><br />
#Configure and initialize phpCAS: <pre>&lt;?php phpCAS::client(CAS_VERSION_2_0,'login.middlebury.edu', 443,'/cas/');&nbsp;?&gt;</pre><br />
#It is preferred to have your application validate the SSL certificate of the CAS server. Our CAS server uses an SSL&nbsp;certificate provided by DigiCert. The Certificate Authority (CA) file to be used is located at: [https://login.middlebury.edu/DigiCertCA.crt https://login.middlebury.edu/DigiCertCA.crt]. Save this file to a place where your application can access it and configure its path in phpCAS:<br><pre>&lt;?php phpCAS::setCasServerCACert('/etc/pki/tls/certs/DigiCertCA.crt');&nbsp;?&gt;</pre>The DigiCert certificate may be installed on your machine already. If so, you should be able to use the bundle file:<pre>&lt;?php phpCAS::setCasServerCACert('/etc/pki/tls/certs/ca-bundle.crt');&nbsp;?&gt;</pre>However, you have problems with the certificate validation (such as your PHP installation not having SSL support), use the following line to skip CAS&nbsp;server certificate validation: <pre>&lt;?php phpCAS::setNoCasServerValidation();&nbsp;?&gt;</pre><br />
#Force authentication when a user tries to view the page: <pre>&lt;?php phpCAS::forceAuthentication();&nbsp;?&gt;</pre><br />
#Contact one of the CAS administrators ([mailto:afrancoATmiddleburyDOTedu Adam Franco] or [mailto:imcbrideATmiddleburyDOTedu Ian McBride]) with the URL of your application so that they can add it to the list of allowed applications.<br />
<br />
=== Example Usage ===<br />
<br />
Below is an example PHP script that will authenticate against the CAS and print out the user id and attributes.<br />
<pre>&lt;?php<br />
<br />
require_once "/path/to/phpCAS/source/CAS.php";<br />
<br />
// set debug mode<br />
phpCAS::setDebug();<br />
<br />
// initialize phpCAS<br />
phpCAS::client(CAS_VERSION_2_0,'login.middlebury.edu', 443,'/cas/');<br />
<br />
// Our CAS&nbsp;server uses an DigiCert certificate, the CA file to be used is located at:<br />
// https://login.middlebury.edu/DigiCertCA.crt<br />
phpCAS::setCasServerCACert('/etc/pki/tls/certs/DigiCertCA.crt');<br />
<br />
// force CAS authentication<br />
phpCAS::forceAuthentication();<br />
<br />
// at this step, the user has been authenticated by the CAS server<br />
// and the user's login name can be read with phpCAS::getUser().<br />
<br />
// logout if desired<br />
if (isset($_REQUEST['logout'])) {<br />
phpCAS::logout();<br />
}<br />
<br />
// for this test, simply print that the authentication was successful<br />
?&gt;<br />
&lt;html&gt;<br />
&lt;head&gt;<br />
&lt;title&gt;Simple CAS client&lt;/title&gt;<br />
&lt;/head&gt;<br />
&lt;body&gt;<br />
&lt;h1&gt;Testing CAS&lt;/h1&gt;<br />
&lt;h2&gt;Successful Authentication!&lt;/h2&gt;<br />
&lt;p&gt;the user's id is &lt;b&gt;&lt;?php echo phpCAS::getUser();&nbsp;?&gt;&lt;/b&gt;.&lt;/p&gt;<br />
&lt;p&gt;phpCAS version is &lt;b&gt;&lt;?php echo phpCAS::getVersion();&nbsp;?&gt;&lt;/b&gt;.&lt;/p&gt;<br />
&lt;p&gt;&lt;a href="?logout="&gt;Logout&lt;/a&gt;&lt;/p&gt;<br />
&lt;hr/&gt;<br />
&lt;pre&gt;<br />
&lt;?php print_r(phpCAS::getAttributes());&nbsp;?&gt;<br />
&lt;/pre&gt;<br />
&lt;/body&gt;<br />
&lt;/html&gt;</pre><br />
<br><br />
<br />
= Proxy Authentication =<br />
<br />
In addition to allowing applications to authenticate users, the CAS protocol also supports proxy authentication. Proxy authentication is when a user-facing application (for example, a blog) passes off ("proxies") authentication information to an underlying service (for example, a directory service). The underlying service needs to verify for itself that the user is who they say they are as well as that the application requesting the information is who it says it is. To accomplish this the CAS protocol includes a bit of back and forth to verify the identities of all parties involved.<br />
<br />
#The user-facing application forwards the user's browser to CAS and includes an HTTPS PGT-callback-URL as a parameter.<br />
#After successful authentication, the CAS server tries to validate the SSL certificate of the callback URL. If validation is successful and the application is allowed to proxy, the CAS server will make a GET request to the callback URL with a a proxy-granting-ticket-IOU (PGTIOU) and a proxy-granting-ticket (PGT) as parameters.<br />
#CAS forwards the browser back to the application with its service ticket (ST).<br />
#The application makes a request to the CAS server to validate its service ticket (ST) and receives back a response with the user id, attributes, and (if a PGT was successfully sent) the PGTIOU.<br />
#The application then uses the PGTIOU to locate the proper PGT stored by its callback URL.<br />
#The application can then include the PGT in requests to underlying services to obtain priviledged resources.<br />
<br />
The [[CAS Directory]] is an example of a service that can be accessed by applications via proxy authentication. Here is an example application and callback script that together can access the directory service. Please note that the application also must have its URL added to CAS&nbsp;by the CAS&nbsp;administrators with the 'Allowed to Proxy' flag enabled. As well, the storePGT.php script must live on an HTTPS url with a server certificate that is signed either by the Middlebury College CA or Verisign. See the [[CAS Directory]] page for more details on using the directory service.<br />
<br />
Below is an example of a basic directory client:<br />
<pre>&lt;?php<br />
<br />
$name = preg_replace('/[^a-z0-9_-]/i', '', dirname($_SERVER['SCRIPT_NAME']));<br />
<br />
session_name($name);<br />
<br />
//<br />
// phpCAS proxied proxy<br />
//<br />
<br />
// import phpCAS lib<br />
include_once('phpcas/source/CAS.php');<br />
<br />
// set debug mode<br />
phpCAS::setDebug();<br />
<br />
// initialize phpCAS<br />
phpCAS::proxy(CAS_VERSION_2_0,'login.middlebury.edu', 443,'/cas');<br />
<br />
// set the callback URL for the PGT to be sent to. This must be an https url<br />
// whose certificate is trusted by CAS.<br />
phpCAS::setFixedCallbackURL('https://example.middlebury.edu/DirectoryClient/storePGT.php');<br />
<br />
// Our CAS server uses a DigiCert certificate, the CA file to be used is located at:<br />
// https://login.middlebury.edu/DigiCertCA.crt<br />
phpCAS::setCasServerCACert('/etc/pki/tls/certs/DigiCertCA.crt');<br />
<br />
// force CAS authentication<br />
phpCAS::forceAuthentication();<br />
<br />
// at this step, the user has been authenticated by the CAS server<br />
// and the user's login name can be read with phpCAS::getUser().<br />
<br />
// moreover, a PGT was retrieved from the CAS server that will<br />
// permit to gain accesses to new services.<br />
<br />
$service = 'https://login.middlebury.edu/directory/?action=search_users_by_attributes&amp;LastName=franco&amp;strict=false';<br />
<br />
?&gt;<br />
&lt;html&gt;<br />
&lt;head&gt;<br />
&lt;title&gt;phpCAS proxied proxy example&lt;/title&gt;<br />
&lt;/head&gt;<br />
&lt;body&gt;<br />
&lt;h1&gt;phpCAS proxied proxy example&lt;/h1&gt;<br />
&lt;p&gt;the user's login is &lt;b&gt;&lt;?php echo phpCAS::getUser();&nbsp;?&gt;&lt;/b&gt;.&lt;/p&gt;<br />
&lt;p&gt;Session: (id &lt;?php print session_id();&nbsp;?&gt;)&lt;/p&gt;<br />
&lt;pre&gt;&lt;?php print_r($_SESSION);&nbsp;?&gt;&lt;/pre&gt;<br />
&lt;h2&gt;Response from service &lt;?php echo $service;&nbsp;?&gt;&lt;/h2&gt;&lt;ul&gt;&lt;hr&gt;<br />
&lt;?php<br />
flush();<br />
// call a service and change the color depending on the result<br />
if ( phpCAS::serviceWeb($service,$err_code,$output) ) {<br />
echo '&lt;font color="#009900"&gt;';<br />
} else {<br />
echo '&lt;font color="#FF0000"&gt;';<br />
}<br />
echo "&lt;pre&gt;\n";<br />
echo htmlspecialchars($output);<br />
echo "&lt;/pre&gt;";<br />
echo '&lt;/font&gt;&lt;hr&gt;&lt;/ul&gt;';<br />
?&gt;<br />
&lt;/body&gt;<br />
&lt;/html&gt;<br />
</pre><br />
And here is the corresponding <code>storePGT.php</code> script:<br />
<pre>&lt;?php<br />
$name = preg_replace('/[^a-z0-9_-]/i', '', dirname($_SERVER['SCRIPT_NAME']));<br />
<br />
session_name($name);<br />
<br />
//<br />
// phpCAS proxied proxy<br />
//<br />
<br />
// import phpCAS lib<br />
include_once('phpcas/source/CAS.php');<br />
<br />
// set debug mode<br />
phpCAS::setDebug();<br />
<br />
// initialize phpCAS<br />
phpCAS::proxy(CAS_VERSION_2_0,'login.middlebury.edu', 443,'/cas');<br />
<br />
// Our CAS server uses a DigiCert certificate, the CA file to be used is located at:<br />
// https://login.middlebury.edu/DigiCertCA.crt<br />
phpCAS::setCasServerCACert('/etc/pki/tls/certs/DigiCertCA.crt');<br />
<br />
// Run the isAuthenticated() method to store the PGT to a temporary file.<br />
phpCAS::isAuthenticated();<br />
<br />
echo "Success";<br />
<br />
<br />
</pre><br />
<br />
= Supported Applications =<br />
<br />
== Applications currently using CAS ==<br />
<br />
*[[GO]] - [http://go.middlebury.edu/ http://go.middlebury.edu/]<br />
*[[MediaWiki|MediaWiki]] - [https://mediawiki.middlebury.edu/ https://mediawiki.middlebury.edu/]<br />
*[[CAS Directory]] - [https://login.middlebury.edu/directory/ https://login.middlebury.edu/directory/]<br />
*[[Drupal]]<br />
*[[WordPress]] - [http://blogs.middlebury.edu/ http://blogs.middlebury.edu/]<br />
*[[Omeka]] - [https://omeka.middlebury.edu/ https://omeka.middlebury.edu]<br />
*[[Segue]] = [https://segue.middlebury.edu https://segue.middlebury.edu]<br />
<br />
== Applications currently being converted to CAS ==<br />
* [[Moodle]] - [https://measure.middlebury.edu/ https://measure.middlebury.edu/] See: [[CASifying Moodle]]<br />
<br />
[[Category:Web Application Development]]<br />
[[Category:CAS]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=File:AdHoc_Guest_account_invitation_flow_-_Helpdesk_supported.png&diff=40379File:AdHoc Guest account invitation flow - Helpdesk supported.png2020-12-16T14:54:09Z<p>Adam Franco: Category:Guest</p>
<hr />
<div>== Summary ==<br />
<br />
<br />
[[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40378Middlebury Guest Account2020-12-16T14:52:53Z<p>Adam Franco: </p>
<hr />
<div><br />
{{Note|The former "MiddGuests" guest account system was retired on December 15, 2020. These accounts are no longer be able to log in. Non-Middlebury users who need access to services after December 15, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
&nbsp;<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=439 "Guest Access via Azure" Helpdesk Ticket].<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
[[File:AdHoc Guest account invitation flow - Helpdesk supported.png|600px|AdHoc Guest account invitation flow.]]<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address.<br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40366Middlebury Guest Account2020-12-15T14:01:22Z<p>Adam Franco: </p>
<hr />
<div><br />
{{Note|The former "MiddGuests" guest account system was retired on December 15, 2020. These accounts are no longer be able to log in. Non-Middlebury users who need access to services after December 15, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
&nbsp;<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=439 "Guest Access via Azure" Helpdesk Ticket].<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Editing_in_Drupal&diff=40365Editing in Drupal2020-12-14T20:01:53Z<p>Adam Franco: Add us3 hostname</p>
<hr />
<div><br />
Part of the documentation on [[Drupal|Drupal]].<br />
<br />
This page contains materials to help you edit content in Drupal. Information can be found for logging on, adding content, editing existing content, creating new pages, setting permissions, etc. Further, each set of instructions will be accompanied by a link to a step-by-step flash tutorial incorporating screen shots to help you complete each task.<br />
<br />
= Logging On =<br />
<br />
Before you can begin creating or editing content, you must first log on to the appropriate server.<br />
<br />
#Navigate to the page you wish to edit. <br />
#Scroll to the bottom of the left column and click the "Site Editor Log On" link. <br />
##You are now at the "Middlebury College Central Authentication Service." <br />
#Your NetID and password are the same as for your Middlebury email account. Type them in the appropriate fields. <br />
#Click the "LOGIN" button <br />
##You are returned to the page you were about to edit. <br />
#You may begin editing. <br />
<br />
= The Edit Console =<br />
<br />
If you are logged in and viewing a page in Drupal where you have editing permission, you will see a multicolored ribbon at the top of your screen with many different actions you can perform on the page. This will not show up when you are viewing a single piece of content, which you can tell because there will be the text '''node/######''' at the end of the URL in your brower's address bar (exception: the [[Drupal_Webform|Webform content type]] has its own edit console that will appear when viewing a webform node.<br />
<br />
The '''Edit Console''' has four sections:<br />
<br />
*'''Content''' (blue): These are actions you can perform on content on the current page. <br />
*'''Page''' (green): These are actions you can perform on the current page. <br />
*'''Sub-pages''' (reddish-orange): These are actions you can perform on sub-pages of the current page. <br />
*'''Help''' (purple): These are links to resources that offer editing assistance. <br />
<br />
== Content ==<br />
<br />
[[File:Drupal Edit Console Content.png|RTENOTITLE]]<br />
<br />
The items in this portion of the menu affect content on the current page, which will be the content currently displayed in the middle of your screen.<br />
<br />
=== View ===<br />
<br />
Clicking this link will bring you to the current page so that you can look and the content on that page.<br />
<br />
=== Add ===<br />
<br />
This allows you to add content to the current page. New content will be placed at the top of the page. Clicking this link will bring you to a page that lets you select the [[Editing_in_Drupal#Content_Types|Content Type]] to add.<br />
<br />
=== Reorder ===<br />
<br />
Each time you add or edit a piece of content, it is placed at the top of the page, above any other existing content. To get content to appear in the order you want, you must reorder it yourself. '''Note: If any content has been made sticky, it will always appear above all other content. If multiple pieces of content are sticky, you can reorder the sticky and non-sticky sections of your page separately.'''<br />
<br />
*Click the "Reorder" tab. The screen now shows the name and type of all content pieces on the page, each with the standard move icon to its left. <br />
*Use the icons to drag the content pieces into the order you want them to appear on the page. <br />
*When you're done, click the "Save configuration" button. <br />
*A message appears to notify you that the contents have been reordered. <br />
<br />
To change the order of items in a sidebar or other non-center content region, click on the "Edit" link above that region (or to the left for the Carousel) and follow the steps above.<br />
<br />
=== Files ===<br />
<br />
This can be used to locate content where an image or document is stored. Paste in the URL of the file on the Drupal site and click "Find!" You will be shown a list of content on the site that references that file. If the file was embedded in content since we upgraded to version 7.x-2.0-beta1 of the Drupal file_entity module (February 8 for www.middlebury.edu or October 23 for other Drupal 7 sites) you will also see a row for wherever it is being used.<br />
<br />
[[File:Drupal Edit Console Files.png|RTENOTITLE]]<br />
<br />
If you need to delete the file, click on the file title, then click "Delete" link -- this will move the file to the recycle bin. A "Delete" button can also be found at the bottom of the Edit form. To permanently delete the file, search for it again to find it in its recycle bin, then click delete a second time.<br />
<br />
== Page ==<br />
<br />
[[File:Drupal Edit Console Page.png|RTENOTITLE]]<br />
<br />
The items in this portion of the menu affect the current page and all content appearing on that page.<br />
<br />
=== Settings ===<br />
<br />
Page Settings refers to a page's properties. These include the name, URL, permissions, appearance, and location in the navigation bar.<br />
<br />
==== General Settings ====<br />
<br />
*'''Page Name''': This is the title of the page, as it will appear in the browser tab and in links to the page in search results. <br />
*'''URL''': This is the fragment of the site URL associated with this page. For example, the URL of the Offices & Services page on the Middlebury site is "offices" as it is located at [http://www.middlebury.edu/offices http://www.middlebury.edu/offices]. If you change the URL of a page after it has been created you may break user-created links to that page, though links in the site navigation will update automatically. <br />
<br />
==== Menu and Layout ====<br />
<br />
Click the ''Don't show this page in the menu'' to hide the link to the page in the navigation menu. '''This does not make the page password protected'''. You will need to change the page permissions for that. Pages which are hidden from the menu cannot be ordered in the menu; they will appear at the bottom of the menu list.<br />
<br />
*'''Location on screen''': See the [[Editing_in_Drupal#Page_Regions|Page Regions]] documentation. <br />
*'''Max number of child levels to display''' and '''Max number of parent levels to display''': As the user gets deeper down in the menu tree, higher-level entries will be removed. This keeps a deeply-nested menu from getting too indented. This setting is inherited by any sub-pages. <br />
<br />
==== Appearance ====<br />
<br />
This section allows you to set the page theme. There are several basic themes you can choose from. See the [[Drupal_Midd_Themes|Middlebury themes]] and [[Drupal_MIIS_Themes|MIIS themes]] documentation for more information about the available options.<br />
<br />
==== Archive ====<br />
<br />
Contents past a certain age will be automatically moved to a secondary page, where they are organized by date, if you choose to use an archive. This is useful for pages where you periodically post information about news and events. Selecting this will prevent you from ordering the items by hand, and instead have them displayed in reverse-chronological order.<br />
<br />
==== Meta Tags ====<br />
<br />
[http://en.wikipedia.org/wiki/Meta_element Meta Tags] can be used to supply additional information about your content to search engines and other programs accessing your content "behind-the-scenes". They are now shown on your page, but do appear in the HTML source of the page. The Meta Description is used by Facebook when you link to a page from that site. It is also often shown below the page link in search result pages in Google, Yahoo, and Bing.<br />
<br />
See the [[Drupal_Meta_Tags|Meta tags documentation]] for more information.<br />
<br />
==== Permissions ====<br />
<br />
Permissions determine what access users have to the page. These range from not even being able to access the page, all the way to full editing privileges. Information on the page level permissions hierarchy can be found at [[Monster_Menus_Permissions|Monster Menus Permissions]].<br />
<br />
The '''All users''' row refers to anonymous visitors to our site. To make a page password-protected, '''remove the Read permission''' from the '''All users''' row and add the groups you wish to have access. You are not allowed to give '''All users''' any permissions other than '''Reader'''.<br />
<br />
The '''Owner''' of a page is typically the person who created or last updated the page. Don't worry too much about who "owns" the page, unless you don't want that person editing it.<br />
<br />
We ''strongly recommend'' that you add '''Groups''' rather than '''Individuals''' to page permissions. This allows you to add and remove members using the [[AD_Group_Manager|Group Manager]] rather than managing them in Drupal, which is both faster and less error-prone.<br />
<br />
= Creating and Managing Pages =<br />
<br />
Most departments have had their architecture built out for them, but there are still pages that must be created. Where a page should appear within your architecture determines where it needs to be created. 2<sup>nd</sup> tier pages should be created from your main page, 3<sup>rd</sup> tier pages should be created from the 2<sup>nd</sup> tier page they supplement, and so on. If done properly, your new page will appear in the proper section of your navigation bar.<br />
<br />
== Adding a Page ==<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the parent of the page you are creating. <br />
#In the red-orange ''Sub-pages'' section at the top of your screen, click the "Add sub-page" tab. <br />
#Enter a name for your page in the "Page name" field. The name should be descriptive because: <br />
#*The page name is what appears at the top of your window. <br />
#*The page name appears in the navigation bar. <br />
#*The page name is used in compiling search results. <br />
#Enter a URL in the "URL" field. <br />
#*The URL determines the web address for the page. <br />
#Scroll down and click the "Create sub-page" button. <br />
##The screen now shows your blank page and asks you to add content. <br />
<br />
== Copying/Moving a Page ==<br />
<br />
To copy or move a page, navigate to the page, then click Copy/Move in the green "Page" section. Select the Mode, then choose the Destination where you want to copy or move the page. You can give the page a new name and URL.<br />
<br />
== Page Regions ==<br />
<br />
Most of the content you create will be added to the "content" region in the middle of the page. However, you can add other editable regions to your pages, enabling you to use more of the space on this design.<br />
<br />
=== New sub-section ===<br />
<br />
Creates a new left navigation menu section and makes the page the top page of the section.<br />
<br />
=== Sidebar ===<br />
<br />
Sidebar content is created using the "Text for Right Column" block. This block will look up in the page tree until it finds a page with content in the block. That content will then be displayed at the current level of the tree. To override Text for Right Column content from a higher level in the tree, create a new page at the current level with this menu appearance.<br />
<br />
For example, if this is your site hierarchy the content on the rightcolumn page will be displayed in the sidebar of all three departments:<br />
<br />
*Home <br />
**Academics <br />
***rightcolumn (Using Text for Right Column menu appearance) <br />
***Biology <br />
***Chemistry <br />
***Economics <br />
<br />
To create a custom sidebar for Chemistry, create a new rightcolumn page at that level:<br />
<br />
*Home <br />
**Academics <br />
***rightcolumn (Using Text for Right Column menu appearance) <br />
***Biology <br />
***Chemistry <br />
****rightcolumn (Using text for Right Column menu appearance) <br />
***Economics <br />
<br />
To create a page using this menu appearance:<br />
<br />
#Navigate to the level in the site information architecture where you wish to create sidebar content. <br />
#Click Add sub-page <br />
#Enter a page name. We recommend "Sidebar Content", but you may use whatever name you like.<br/> '''**NOTE: If the page name already has a name, go back and click on the ADD&nbsp;SUB-PAGE TAB.''' <br />
#Enter a URL name. We recommend "sidebar", but you may use whatever name you like.<br/> '''**NOTE: If it already has a url, go back and click on the ADD SUB-PAGE TAB.''' <br />
#Expand Menu and layout. <br />
#Under "Location on screen" choose "Text for right column". <br />
#Make other page settings, such as Permissions as you normally would for a new page. <br />
#Click Create sub-page. <br />
<br />
You can now add content to the sidebar using content types as you normally would for page content. The content you add here will be displayed in the Sidebar. You should also now see an Edit link in the Sidebar. This will allow you to return to content editing for Sidebar content at this level and any other where this Text for Right Column page will be displayed.<br />
<br />
=== Carousel ===<br />
<br />
Created using the "Carousel" block, this region displays content in a scrolling bar at the bottom of the page. This block will look up in the page tree until it find a page with content in the block. That content will then be displayed at the current level of the tree. To override Carousel content from a higher level in the tree, create a new page at the current level with this menu appearance.<br />
<br />
For example, if this is your site hierarchy the content on the rightcolumn page will be displayed in the sidebar of all three departments:<br />
<br />
*Home <br />
**Academics <br />
***carousel (Using Carousel menu appearance) <br />
***Biology <br />
***Chemistry <br />
***Economics <br />
<br />
To create a custom sidebar for Chemistry, create a new carousel page at that level:<br />
<br />
*Home <br />
**Academics <br />
***carousel (Using Carousel menu appearance) <br />
***Biology <br />
***Chemistry <br />
****carousel (Using Carousel menu appearance) <br />
***Economics <br />
<br />
To create a page using this menu appearance:<br />
<br />
#Navigate to the level in the site information architecture where you wish to create carousel content. <br />
#Click Settings <br />
#Click Add sub-page <br />
#Enter a page name. We recommend "Carousel", but you may use whatever name you like. <br />
#Enter a URL name. We recommend "carousel", but you may use whatever name you like. <br />
#Expand Appearance. <br />
#Expand Menu appearance. <br />
#Under "Location on screen" choose "Carousel". <br />
#Make other page settings, such as Permissions as you normally would for a new page. <br />
#Click Create sub-page. <br />
<br />
You can now add content to the carousel using content types as you normally would for page content. The content you add here will be displayed in the Carousel. Scroll to the left edge of the Carousel to see the Edit link for the Carousel. This will allow you to return to content editing for content at this level and any other where this Carousel page will be displayed.<br />
<br />
If you use the "File Upload" content type to place an image in the Carousel, text cannot be added around the image.<br />
<br />
To add an image to the Carousel with additional text:<br />
<br />
#Navigate to the Carousel Editor <br />
#Add a "Basic Content" type. <br />
#Provide a title for the content. If you do not wish to have this title show in the Carousel, place the title in between a set of brackets. Example: [Title] <br />
#In the WYSIWYG editor, Embed the image in the editor using the directions provided at the following link: [http://mediawiki.middlebury.edu/wiki/LIS/Drupal_File_Upload#Embedding_in_Other_Content http://mediawiki.middlebury.edu/wiki/LIS/Drupal_File_Upload#Embedding_in_Other_Content]. Note: If you previously uploaded your image, it may appear in another File Upload folder depending on which level the image was added. <br />
#You can adjust the size of the image once it has been placed in the WYSIWYG editor by selecting the image and moving the corners to the size you require. <br />
#Add the text that you wish to add around the image within the WYSIWYG editor. <br />
#If you wish to include text but need to adjust the alignment of the image within the editor: <br />
##Click on the image so that it is selected <br />
##Click the Insert/Edit Image button. This button will look like a tree and will appear to the right of the overlapping mountains you used for uploading the image. <br />
##In the Insert/Edit Image window, you will see an Appearance tab. In this tab, you can adjust the alignment of the photo as well as other style attributes. <br />
<br />
&nbsp;<br />
<br />
=== Banner image ===<br />
<br />
Like the regions above, banner images can be added by creating a sub-page and assigning it to the "Site Banner" region:<br />
<br />
[[File:SiteBanner.png|frame|SiteBanner.png]]<br />
<br />
Once you have created the sub-page for the site-banner, you can add an image as File-upload content and it will display with no further action.<br />
<br />
To do this:<br />
<br />
*Select "Edit" to edit the site banner sub-page. <br />
*You should now be located in the site banner page and will see that reflected in the path at the top of your content area <br />
*You will go up to the content editor at the top of the screen and click "Add" to add your image. <br />
*Select "File Upload" from the available content types to upload the banner image you wish to add to the banner site <br />
*Save and you should have successfully added your banner image. <br />
<br />
<br/> &nbsp;<br />
<br />
= Content Types =<br />
<br />
Drupal organizes information into '''Content Types''', which have a unique list of fields and a distinct way to display the content. For example, a content type for a news story might have fields for a title, the body of the story, and a dateline. A content type for a user profile might have fields for the person's job title, email address, and telephone number. Drupal organizes the information in these fields and displays them on the site.<br />
<br />
This section describes each of the types of content available on our site.<br />
<br />
#[[Drupal_Basic_Content|Basic Content]] <br />
#[[Drupal_Course_Listing|Course Listing]] <br />
#[[Drupal_Event|Event]] <br />
#[[Drupal_Facebook_Element|Facebook Element]] <br />
#[[Drupal_File_Upload|File Upload]] <br />
#[[Drupal_FAQ|Frequently Asked Question]] <br />
#[[Drupal_Gallery|Gallery]] <br />
#[[Drupal_Google_Calendar|Google Calendar]] <br />
#[[Drupal_MiddLab_Widget|MiddLab Widget]] <br />
#[[Drupal_News|News]] <br />
#[[Faculty_Profiles_in_Drupal|Profile]] <br />
#[[Drupal_Promotional_Calendar|Promotional Calendar]] <br />
#[[Drupal_Quick_Access|Quick Access]] <br />
#[[Drupal_Redirector|Redirector]] <br />
#[[Drupal_RSS_Page|RSS feed]] <br />
#[[Drupal_Slideshow|Slideshow]] <br />
#[[Drupal_Story|Story]] <br />
#[[Drupal_Subpage_List|Subpage list]] <br />
#[[Drupal_Webform|Webform]] <br />
<br />
= Managing Content =<br />
<br />
Once a content piece is created and saved, you can always go back and change it. You can edit the content, change the content permissions, adjust the scheduling, set what pages the content appears on, and reorder content on the page. '''Note: These tasks can also be done while initially creating the content.'''<br />
<br />
== Edit Content ==<br />
<br />
When a content piece is created, you can change anything that could also have been initially done during the creation of the content. To do this:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content you wish to edit. <br />
#Scroll below the content piece you wish to edit and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Make the desired changes to your content. <br />
#When you are done editing the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
=== Links ===<br />
<br />
[[File:Drupal Editing Links.png|RTENOTITLE]]<br />
<br />
==== Creating a New Link ====<br />
<br />
#Highlight the text you wish to be the link. <br />
#Click the "Insert/edit link" button. It looks like a chain link. It is the button on the left in the image above. <br />
##The "Insert/edit link" console appears on your screen. <br />
#In the "Link URL" text field, put in the URL for the page you wish to link to. <br />
#Click the "Insert" button. <br />
##The "Insert/edit link" console disappears. <br />
#When you are done editing the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
==== Creating a Link Anchor ====<br />
<br />
#Highlight the text you wish to be the anchor target. <br />
#Click the "Insert/Edit Anchor" button. It looks like a boat anchor. It is the button on the right in the image above. <br />
#In the "Anchor Name" field type a single word to describe your anchor. Do not include the pound (#) symbol in the Anchor Name. <br />
#Click the Insert button. <br />
#Now highlight the text that you wish to be the link to the anchor. <br />
#Click the "Insert/edit link" button. It looks like a chain link. It is the button on the left in the image above. <br />
#In the "Link URL" field type the pound (#) symbol and then the word that you entered in step 3. <br />
#Click the Insert button. <br />
<br />
==== Removing a Link ====<br />
<br />
#Highlight all of the text in the link you wish to remove. <br />
#Click the "Unlink" button. It looks like a broken chain link. It is the button in the middle in the image above. <br />
<br />
==== Changing a Link ====<br />
<br />
Follow the directions in the "Creating a New Link" section above. The text you highlight initially will be the full text of the existing link.<br />
<br />
==== Having a Link Open in a New Window or Tab ====<br />
<br />
We '''strongly''' advise against setting a link to open in a new window or tab. This interrupts the user's experience. If they wish to get back to your site, most people prefer to use the Back button, which opening a link in a new window breaks. By default, links to sites outside of "www.middlebury.edu" will open in a new browser window or tab when someone clicks on them. If you would like to change this behavior for one of your links:<br />
<br />
#Highlight the text you wish to be the link. <br />
#Click the "Insert/edit link" button. It looks like a chain link. <br />
#Click the "Target" menu and select "Open in this window / frame". <br />
#Click Update. <br />
<br />
=== Images ===<br />
<br />
==== Uploading an Image ====<br />
<br />
In our site, images are normally uploaded to a hidden '''File Uploads''' page that holds all of the images for a section of the site.<br />
<br />
If the '''File Uploads''' page already exists...<br />
<br />
#Navigate to the '''File Uploads ''' page. <br />
#Click '''Add Content''' in the editing menu:<br/> [[File:MM-Add Content.png|none|300px|Add content screenshot]] <br />
#Choose '''File Upload''' in the content list:<br/> [[File:MM-File Upload.png|none|300px|File upload option screenshot.]] <br />
#Select your file and save the new content. <br />
<br />
If the '''File Uploads''' page doesn't exist...<br />
<br />
#Add a new Page to your section of the site and title it '''File Uploads''' <br />
#Under the '''Menu and Layout''' tab, choose '''Don't show this page in the menu'''<br/> [[File:MM-Hide from menu.png|none|300px|Hide from menu screenshot.]] <br />
#Save the new page. <br />
<br />
==== Inserting an image into content ====<br />
<br />
'''Note: These instructions apply to the "Basic Content" and "Story" content types.'''<br />
<br />
#Make sure you are logged on and in the editing interface for the content you wish to edit. <br />
#Click in your text in the area you wish to add an image. <br />
#Click the "Insert file upload" button. It's the 1<sup>st</sup> button in the 3<sup>rd</sup> row. <br />
##The "Insert file upload" console appears on your screen. <br />
#Use the links the find the files on the "File Uploads" page. <br />
#Click the image you wish to use. <br />
##A new window appears. <br />
#Use this screen to set the properties you want for the image. These cannot be changed later. <br />
#When you're done setting the properties, click the "Insert" button. <br />
##The window disappears. <br />
#To edit the image's settings, make sure it is selected and click the "Insert/edit image" button. It's the 2<sup>nd</sup> button in the 3<sup>rd</sup> row. <br />
##A new window appears. <br />
#Click the appearance tab. <br />
##You now see the image's appearance settings. <br />
#Edit the image as required. <br />
#When you're done editing the image settings, click the "Update" button. <br />
##The window disappears. <br />
#When you are done editing the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
&nbsp;<br />
<br />
=== Video ===<br />
<br />
'''Note: These instructions apply to the "Basic Content" and "Story" content types.'''<br />
<br />
Videos can be pulled from just about anywhere on the web, including YouTube and MiddTube. The syntax for inserting videos is:[video:URL width:value height:value align:value autoplay:value autorewind:value loop:value image:URL]. The video URL is the address of the site you found the video on. Accepted values for width and height are numbers. Accepted values for align are left and right. Accepted values for autoplay, autorewind and loop are 0 (false) and 1 (true). The image URL is used to change the "splash image" or the image show in the player when the video is not playing. Other than the video URL, all attributes are optional. To insert a video:<br />
<br />
#Make sure you are logged on and in the editing interface for the content you wish to edit. <br />
#Click in the text where you want to add a video. <br />
#Enter the line of code above, [video:URL width:value height:value align:value], inputting the desired URL and appropriate values. <br />
#When you are done adding the video, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
&nbsp;<br />
<br />
==== Panopto Videos ====<br />
<br />
#Log into Panopto and find the video in question. <br />
#Click the "Sharing" button for the video. <br />
#Copy the "Link" value for the video. <br />
#Put that link in a [[Drupal_Shortcodes|[video: ] shortcode]] in the Drupal text.<br/> Example:<br/> <code>[video:[https://midd.hosted.panopto.com/Panopto/Pages/Viewer.aspx?id=ee720a32-5f06-4ef4-b7df-aae20123e96a https://midd.hosted.panopto.com/Panopto/Pages/Viewer.aspx?id=ee720a32-5f06-4ef4-b7df-aae20123e96a]]</code> <br />
<br />
[[File:Panopto sharing example.png|600px|Panopto sharing example]]<br />
<br />
==== YouTube Playlists ====<br />
<br />
You can add a YouTube playlist by adding the playlist ID in the video URL. For example:<br />
<br />
[video:[http://www.youtube.com/watch?v=DaCP2kdYA4A&p=17B9CA1B31A33C5E http://www.youtube.com/watch?v=DaCP2kdYA4A&p=17B9CA1B31A33C5E]]<br />
<br />
or<br />
<br />
[video:[http://www.youtube.com/watch?v=DaCP2kdYA4A&list=17B9CA1B31A33C5E http://www.youtube.com/watch?v=DaCP2kdYA4A&list=17B9CA1B31A33C5E]]<br />
<br />
In these examples, the playlist ID follows the "p=" or "list=" parts of the URL.<br />
<br />
==== HTML5 Video ====<br />
<br />
Videos from MiddMedia will appear using the browser's built-in video player in the following browsers:<br />
<br />
#Safari <br />
#Mobile Safari for the iPad and iPhone <br />
<br />
Audio from MiddMedia will appear using the browser's built-in video player in the following browsers:<br />
<br />
#Safari <br />
#Mobile Safari for the iPad and iPhone <br />
#Chrome <br />
<br />
Other browsers will fallback to using the Adobe Flash version of the player. Videos from YouTube will play using a player from that site that detects the correct player type to use based on the browser and YouTube user preferences.<br />
<br />
==== Ustream Video ====<br />
<br />
To embed a Ustream video (or channel) use the following syntax: [video:URL] To obtain the correct URL, visit the Ustream channel, click on the Share button and select the Embed option <>. Highlight and copy the URL that has the word /embed/. Insert this link on your Drupal page using the following syntax: [video:[http://www.ustream.tv/embed/13154933 http://www.ustream.tv/embed/13154933]]<br />
<br />
=== Locations ===<br />
<br />
You can "geo-tag" your content to let people know that it is about a specific place. This is something you might want to do with a news story about student activity in an interesting location, or a program description of a course at a school abroad. This information can then be used to build a dynamic map of the different locations where your content appears. Send us an email if you're interested in creating this type of map. To add a location to your content:<br />
<br />
#When editing a piece of content, expand the Locations and then Location section at the bottom of the form. <br />
#Enter the address information for your locations. For most countries, this will automatically be translated into a Latitude and Longitude when you save the content. <br />
#Click Save. <br />
<br />
=== Meta Tags ===<br />
<br />
[[http://en.wikipedia.org/wiki/Meta_element Meta Tags]] can be used to supply additional information about your content to search engines and other programs accessing your content "behind-the-scenes". They are now shown on your page, but do appear in the HTML source of the page. The Meta Description is used by Facebook when you link to a page from that site. It is also often shown below the page link in search result pages in Google, Yahoo, and Bing.<br />
<br />
Because Meta Tags are added to nodes and we often show multiple nodes on each page, they will only work for individual nodes, like individual news stories. If you do not enter a Meta Description, one will be created for your content using the first few sentences from the content body.<br />
<br />
To edit the Meta Keywords or Meta Description:<br />
<br />
#Click the Edit link below the content. <br />
#Expand the Meta tags section near the bottom of the edit form. <br />
#Enter values for the keywords and/or description fields. <br />
#Click Save. <br />
<br />
=== Pasting from Word ===<br />
<br />
When copy/pasting from Microsoft Word, Word includes extra garbage markup that will be hidden in the editor, but show up in the output after the page is saved. Use the "Paste from Word" button on the editor toolbar to automatically strip out this extra markup when copy-pasting from Word.<br />
<br />
[[File:Drupal Paste From Word.png|500px|Drupal Paste From Word.png]]<br />
<br />
If you forget to use the "Paste from Word" toolbar button, use these steps to remove the extra markup:<br />
<br />
#Select all text in the visual editor <br />
#Use the toolbar button to copy the text <br />
#Use the "Paste from Word" button on the editor toolbar to automatically strip out the extra markup. <br />
#Save the content node to apply the changes. <br />
<br />
For even more drastic cleanup, highlight all text and use the "Remove Formatting" button to clear out all custom styles. You can then add formatting back in using the toolbar buttons.<br />
<br />
[[File:Drupal remove formatting.png|500px|Drupal remove formatting.png]]<br />
<br />
&nbsp;<br />
<br />
To manually clean up Word markup follow these steps: [[File:Drupal Cleanup Word Markup.png|500px|Drupal Cleanup Word Markup.png]]<br />
<br />
#Click the "HTML" button in the editor toolbar <br />
#Select the extra markup and delete it. <br />
#Click the "Update" button to save the changes back to the visual editor. <br />
#Save the content node to apply the changes. <br />
<br />
=== Tables ===<br />
<br />
To add and remove table columns from existing columns in the WYSIWYG editor, first click on a cell in the table and then look for these buttons in the editor:<br />
<br />
[[File:Drupal WYSIWYG Table Buttons.png|500px|Drupal WYSIWYG Table Buttons.png]]<br />
<br />
To change column widths and other properties, click in the table-cell you want to change, then use the '''Table Cell Properties''' button:<br />
<br />
[[File:Drupal Edit Table Cell Properties.png|500px|Edit table-cell properties including width.]]<br />
<br />
=== Embedding Interactive Elements ===<br />
<br />
For security reasons, users cannot insert Javascript code into the HTML of the site. To get around this limitation there are short-codes provided to allow embedding interactive widgets for select services, below.<br />
<br />
<br />
==== MailChimp ====<br />
<br />
You can embed a MailChimp campaign in a page with <code>[mailchimp URL]</code>. Example:<br />
<pre>[mailchimp //middlebury.us7.list-manage.com/generate-js/?u=050d2dfab1151df6a95fe1409&fid=06269&show=10]</pre><br />
<br />
{{note|Note: campaigns must be hosted at <code>middlebury.us3.list-manage.com</code> or <code>middlebury.us7.list-manage.com</code>.}}<br />
<br />
== Permissions ==<br />
<br />
=== Hierarchy ===<br />
<br />
Information on the content level permissions hierarchy can be found at [[Monster_Menus_Permissions|Monster Menus Permissions]].<br />
<br />
=== How to Change ===<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content who's permissions set you wish to change. <br />
#Scroll below the content piece you wish to alter permissions for and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Who can edit or delete this content" link above the "Save" button. <br />
##The list of users with editing privileges appears. <br />
#There are 2 ways to add users to this permissions set. You can: <br />
#*Add individuals. <br />
#*#Use the text field to search for a user. As you type, matches will appear below. <br />
#*#Click on a person's name to add them to the list. <br />
#*Add groups. <br />
#*#Click the "Add" button. <br />
#*##A new window pops up. <br />
#*#Use the links to navigate to the group you wish to add. <br />
#*#Once you've found the group, click the "Select" link to the right of the group's name to add them to the list. <br />
#*##The extra window disappears. <br />
#When you are done setting the permissions set, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
== Appearance ==<br />
<br />
You have control over 2 appearance features for content. You can choose to make it sticky at the top of the page, and you can change its attribution style.<br />
<br />
=== Sticky ===<br />
<br />
Each time you add or edit a piece of content, it is placed at the top of the page, above any other existing content. By default, content is not sticky, but making content sticky at the top of the page forces it to remain above any other content. To control whether or not content is sticky:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content who's stickiness you wish to change. <br />
#Scroll below the content piece you want to make sticky and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Appearance" link. <br />
##You now see the content's appearance properties. <br />
#To make the content sticky, make sure the checkbox to make the content sticky at the top of the page is checked. <br />
#When you are done altering the stickiness, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
=== Attribution ===<br />
<br />
Each piece of content created stores information on who created it and when it was created. By default, content displays a message indicating the user that submitted the content. To change the attribution message:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content who's attribution message you wish to change. <br />
#Scroll below the content piece you want to modify and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Appearance" link. <br />
##You now see the content's appearance properties. <br />
#Use the "Attribution style" dropdown menu to change the attribution message. <br />
#When you are done altering the attribution message, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
== Scheduled Publishing ==<br />
<br />
Editing the Publish settings on a piece of content allows you to control when the content is published. This allows you to set a future start date for it to appear on your site, as well as a date for it to be automatically removed from your page. The Publishing setting is particularly effective for temporary content, or content that gets reused based on a schedule. To set publish dates:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content you wish to schedule. <br />
#Scroll below the content piece you wish to schedule and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Publishing" link above the "Meta tags" label. <br />
##New text fields appear for setting publish dates and times. <br />
#Type the necessary dates and times into the "Publish on" and/or "Unpublish on" text fields. <br />
#When you are done setting publish dates for the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
&nbsp;<br />
<br />
== Pages ==<br />
<br />
If you have content you want to appear on multiple pages, you still only have to create it once. Once it is created, use the following instructions to make it appear on all other desired pages.<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content you wish to duplicate. <br />
#Go below the content piece and click the "Edit" link. <br />
##The screen now shows the editing interface for your content. <br />
#Scroll down if necessary and click the "Pages" link above the "Save" button.<br/> [[File:D7-node-pages-ui.png|center|500px|The Pages dialog on Drupal 7 nodes. A list of the pages that display this content appears, along with 3 new buttons.]]<br/> The Pages dialog on Drupal 7 nodes. A list of the pages that display this content appears, along with 3 new buttons. <br />
#You can: <br />
#*Add a page. <br />
#*#Click the "Add..." button. <br />
#*##A window appears with an index of the entire site. <br />
#*#Navigate to the page you wish to add the content to and click the "Select" link on the right hand side. <br />
#*##The window disappears and the new page is added to the list. <br />
#*Replace a page. <br />
#*#Click the name of the page you wish the content to no longer appear on. <br />
#*#Click the "Replace..." button. <br />
#*##A window appears with an index of the entire site. <br />
#*#Navigate to the page you wish to add the content to and click the "Select" link on the right hand side. <br />
#*##The window disappears and the new page is added to the list while the old one has been removed. <br />
#*Delete a page. <br />
#*#Click the name of the page you wish the content to no longer appear on. <br />
#*#Click the "Delete" button. <br />
#*##The name of the page is removed from the list. <br />
#When you are done managing the pages, click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
[[Category:Drupal]] [[Category:Web Application Development]] [[Category:Drupal Academics]] [[Category:Public Search]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40311Middlebury Guest Account2020-12-01T22:05:27Z<p>Adam Franco: </p>
<hr />
<div>= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
<br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=439 "Guest Access via Azure" Helpdesk Ticket].<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40310Middlebury Guest Account2020-12-01T22:04:57Z<p>Adam Franco: Add WHD link</p>
<hr />
<div>= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
<br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=439 "Guest Access" Helpdesk Ticket].<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40309Middlebury Guest Account2020-12-01T14:26:08Z<p>Adam Franco: Swap order of old/new docs.</p>
<hr />
<div>= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a Helpdesk Ticket:<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Create_Middlebury_Full_Guest_Account&diff=40308Create Middlebury Full Guest Account2020-11-30T22:02:53Z<p>Adam Franco: </p>
<hr />
<div><br />
{{Note|The guest account system described here is being retired on December 15, 2020. See [[Middlebury_Guest_Account|Middlebury Guest Account]] for a description of the new process.}}<br />
<br />
Creating your Middlebury '''full-feature''' guest account can be done prior to a campus visit or after you arrive. Refer to [[Middlebury_Guest_Account|Middlebury Guest Account]] to learn more about the resources you can access.<br />
<br />
&nbsp;<br />
<br />
#Using your preferred web browser, visit '''[http://go.middlebury.edu/guest http://go.middlebury.edu/guest]'''. <br />
#Under ''New Guest Accounts'', click the '''Register an Account''' button. <br />
#Fill in the required information as requested, then click the '''Create''' button. <br />
#You’ll see a ''Verification'' screen stating that a message containing an activation link has been sent to the email address you provided. <br />
#Now you’re almost there! To complete the guest account creation process, access your email account then open the message with the subject line “'''Welcome to Middlebury College Guest Network'''.” (Don’t forget to check your Junk and Spam folders.) <br />
#Click the verification link in the message. You’ll see the ''Success'' screen, confirming that you may now use the specified email address and password to access designated Middlebury services, including our [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|MiddleburyCollege wireless network]]. <br />
<br />
<br/> <br/> See also: [[Wireless|Wireless]]<br />
<br />
&nbsp;<br />
<br />
reviewed 1/17/2020<br />
<br />
[[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40307Middlebury Guest Account2020-11-30T22:00:03Z<p>Adam Franco: </p>
<hr />
<div><br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a Helpdesk Ticket:<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=File:Guest_login_passcode.png&diff=40306File:Guest login passcode.png2020-11-30T21:59:03Z<p>Adam Franco: Category:Guest</p>
<hr />
<div>== Summary ==<br />
<br />
<br />
[[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40305Middlebury Guest Account2020-11-30T21:58:31Z<p>Adam Franco: </p>
<hr />
<div><br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a Helpdesk Ticket:<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
<br />
<br />
<br />
<br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail.png|500px|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode.png|500px|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
[[Category:Pages with broken file links]]<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=File:Guest_login_GMail.png&diff=40304File:Guest login GMail.png2020-11-30T21:57:33Z<p>Adam Franco: </p>
<hr />
<div></div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40303Middlebury Guest Account2020-11-30T21:52:17Z<p>Adam Franco: </p>
<hr />
<div><br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a Helpdesk Ticket:<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
<br />
<br />
<br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|500px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|500px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
[[Category:Pages with broken file links]]<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=Middlebury_Guest_Account&diff=40302Middlebury Guest Account2020-11-30T21:51:52Z<p>Adam Franco: </p>
<hr />
<div><br />
= Guest accounts (new system Dec 15, 2020) =<br />
<br />
People without Middlebury accounts may be granted access to select Middlebury resources using a guest account tied to their personal email address. Guest accounts do not require a separate username and password to log in, but instead are tied to the guest’s own email account. GMail and Microsoft Office 365 accounts use Google or Microsoft’s single-sign-on prompts for login. For other email providers, a one-time-passcode will be mailed for each login session.<br />
<br />
== Requesting a guest account ==<br />
<br />
Middlebury students, faculty, and staff may request guest access for any external users by submitting a Helpdesk Ticket:<br />
<br />
You will need:<br />
<br />
*The email address of the external user. <br />
<br />
Please indicate in the request what services the external user will need access to:<br />
<br />
*Canvas <br />
*WordPress (sites.middlebury.edu and sites.miis.edu) <br />
<br />
Guest access will not allow external users to create spaces/sites/resources in Canvas or WordPress, but will allow them to log in and be assigned individual permissions.<br />
<br />
== Process for granting access to guest accounts ==<br />
<br />
=== WordPress ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into WordPress. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into WordPress at sites.middlebury.edu or sites.miis.edu to create their account in Wordpress. <br />
#(Middlebury User): Log into WordPress and grant the guest account an appropriate level of access to their WordPress site (Subscriber, Contributor, Author, Editor, Administrator). You can find the new guest account by searching for the external user’s email address. <br />
<br />
=== Canvas ===<br />
<br />
#(Middlebury User): Request a guest account via Helpdesk Ticket (details above) <br />
#(ITS): Will create the guest account and grant it access to log into Canvas. <br />
#The requester will be notified when this is complete. <br />
#(External User): Will need to accept the guest account invitation and accept our privacy policies. <br />
#(External User): Will need to log into Canvas at [https://middlebury.instructure.com/ https://middlebury.instructure.com/] using the email address of the guest account so to create their account in Canvas. <br />
#(Middlebury User): Log into Canvas and grant the guest account an appropriate role in their Canvas course. You can find the new guest account by searching for the external user’s email address. <br />
<br />
<br />
<br />
<br />
== Logging in with your guest account ==<br />
<br />
1. Head to the service that you wish to log into and click the login link if you are not prompted to log in.<br />
<br />
[[File:WordPress Login.png|100px|Screen shot of WordPress login link.]]<br />
<br />
2. On the Middlebury sign in page, enter the email address associated with your guest account.<br />
<br />
[[File:Guest Login Form.png|100px|Screen shot of the login form asking for an email address.]]<br />
<br />
3. a. (for GMail / O365 accounts) you will be prompted to select your GMail / O365 account:<br />
<br />
[[File:Guest login GMail|Screen shot of the GMail login dialog]]<br />
<br />
3. b. (for other email providers) you will be emailed a one-time code that you will need to enter to sign in.<br />
<br />
[[File:Guest login passcode|Screen shot of the one-time-passcode dialog]]<br />
<br />
4. After completing the login you will be redirected to the application and signed in.<br/> If this is your first time logging in with this account you will be prompted to accept Middlebury’s privacy policy.<br />
<br />
&nbsp;<br />
<br />
[[Category:Pages with broken file links]]<br />
<br />
== What guests will have access to ==<br />
<br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a login (open-enrollment courses) <br />
<br />
{{note|This list will expand over time as we make additional services available.}}<br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
*Can be given access to documents in Office 365. <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*[[Panopto|Panopto]] <br />
*[[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*[[Course_Catalog|Course Catalog]] <br />
*[[CourseHub|CourseHub]] <br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
*Submitting Web Help Desk tickets <br />
<br />
&nbsp;<br />
<br />
= "MiddGuests" guest accounts (going away Dec 15, 2020) =<br />
<br />
{{Note|The former "MiddGuests" guest account system will be retired on December 15, 2020. After December 15th these accounts will no longer be able to log in. Non-Midddlebury users who need access to services after December 15th, 2020 will need to have new guest accounts registered and granted access.}}<br />
<br />
You can [[Create_Middlebury_Full_Guest_Account|create a new, '''full-featured''' guest account]] using any e-mail account (except @middlebury.edu or @miis.edu addresses). A '''full''' guest is account is required for access to the college resources outlined below.<br />
<br />
Just looking for a wireless internet connection and nothing more? You can [[Create_Basic_Guest_Wireless_Account|create a '''basic''' guest wireless account]] that is valid for four days.<br/> &nbsp;<br />
<br />
== What guests will have access to ==<br />
<br />
*The [[Connect_to_Wireless#The_MiddleburyCollege_Wireless_Network|'''MiddleburyCollege''']] wireless network <br />
**This includes access to most library e-resources while in the libraries. <br />
*[[Course_Catalog|Course Catalog]] (can create schedules, but not email them) <br />
*[[CourseHub|CourseHub]] - Can log in, but cannot see class spaces. <br />
*Commenting on [[WordPress|WordPress]] (sites.middlebury.edu) <br />
*[[Canvas|Canvas]] sites open to anyone with a Middlebury login (placement tests) <br />
<br />
== What guests can be given access to ==<br />
<br />
You will need to contact a person with a regular Middlebury account and request access.<br />
<br />
*Can be made contributors/authors/editors of [[WordPress|WordPress]] sites (sites.middlebury.edu) <br />
*Can be made teacher/students of [[Canvas|Canvas]] sites. (Added directly in Canvas, not via class-groups) <br />
*Can be made editors in [[MediaWiki|MediaWiki]] (mediawiki.middlebury.edu) <br />
*Can be granted access to course sites using Canvas. (Added directly in Canvas, not via class-groups) <br />
<br />
== What guest accounts created this way will not have access to ==<br />
<br />
*Editing in [[Drupal|Drupal]] (www.middlebury.edu, www.miis.edu, museum.middlebury.edu) <br />
*Creating [[GO|GO]] links <br />
*Creating a [[WordPress|WordPress]] site. <br />
*Course Hub spaces for courses. <br />
*Public computers (though they can get a daily guest password from the Circulation Desk) <br />
*Printing (though they can purchase [http://www.middlebury.edu/offices/technology/help/technology/printing/accounts#guests_accounts guest printing cards]) <br />
*[[MiddFiles|MiddFiles]] <br />
*Uploading to [[MiddMedia|MiddMedia]] <br />
*Submitting Web Help Desk tickets <br />
<br />
[[Category:Pages with broken file links]] [[Category:Helpdesk]] [[Category:Helpdesk Documentation]] [[Category:Public Search]] [[Category:Guest]]</div>Adam Francohttps://mediawiki.middlebury.edu/LIS/index.php?title=File:Guest_Login_Form.png&diff=40301File:Guest Login Form.png2020-11-30T21:50:41Z<p>Adam Franco: </p>
<hr />
<div></div>Adam Franco