Lists of organisations
GovWifi has 3 different lists of organisations.
- The public list: this is the list we share on our product page. The primary goal is to show potential organisations that GovWifi is trusted and used across government. We also assume it reassures some end users that it’s ok to use.
- The admin organisation list: superadmins can see this list to check what organisations have signed up on the admin tool.
- The allow list: this list helps to filter out inappropriate organisations from signing up
The public list
The public list should mostly mirror the list of organisations setup on the admin tool. It isn’t an exact copy because:
- Some organisations don’t want to be shown publicly for security reasons
- Some admin organisation names are for the third party who operates their network and we’re trying to show public sector organisations where it’s available not operators
- Some organisations’ locations have GovWifi but they don’t control it, for example, another organisation may run the building’s network. In this case we’d still like to show the ‘consuming admin’s’ organisation
Updating the public list
- The latest organisations.yml is published to the admin tool’s S3 bucket at 22:00 UTC every day.
- Organisations don’t appear automatically on the public list, they need to be approved.
- Run the product page’s GitHub action Fetch an updated list of organisations that use GovWifi from GovWifi-Admin
- This will create a pull request that needs to be approved and merged. Follow this link to see an example PR which adds an organization to the list
- Once the PR is merged the product page site needs rebuild and deploying
- Run the Github action Deploy-to-github-pages
- The build and deploy will take a few minutes to run.
- Check the organisation appears on the public list.
- If it doesn’t appear, rerun the deploy action as this sometimes doesn’t work.
- If this still doesn’t work, check the production organisations.yml file to see of the organisation is listed.
Note:
- The Organisation will not be present in organisations.yml if the new organisation has not been created by its IT administrators.
The admin organisation list
The admin tool list is an accurate list of organisations which are signed up as admins so that we know who’s offering GovWifi and can contact them if necessary. When a new organisation signs up as an admin it does not automatically go on the public list.
This list is updated by new organisations signing up. An organisation can be deleted by a superadmin.
The allow list
The allow list helps to prevent inappropriate organisations signing up to GovWifi. If an organisation wants to register but is not on the list they will be prompted to contact GovWifi for help and we can add them to the allow list.
This list is comprised of two lists:
- A list on admin tool that superadmins can add or remove
- A hard coded list which was created when the previous register of organisations was switched off
You will only be able to register an organisation if the name appears on either of these lists. You cannot register if that organisation has already been registered. These lists will get out of date as new organisations get created or existing ones get renamed. In this instance we expect organisations who are trying to register will tell us and we’ll update one of the lists.
The allow list can be edited by a Superadmin in the allow list tab.