Skip to content

Client-side web-app that will generate Android, iOS and Windows profiles in their raw format

Notifications You must be signed in to change notification settings

Tundra-bit/WiFiProfileGenerator

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WiFi Mobile Configuration Profile Generator

Table of contents

What does it do?

Back to top

When you manage your mobile devices (specifically, iOS, Android or Windows devices) via any source - an MDM, for example... this provider sends your device a Configuration Profile - this is the raw data that contain the information that they want to configure on your device.

I've ran into a lot of scenarios where I need to make a Wi-Fi profile manually - troubleshooting, testing, or simply installing a standalone one without an MDM. On iOS, this is normally possible with a tool Apple provides called Apple Configurator - I do not have a Mac, and this tool only works on Mac devices - so this is the best next thing! Windows & Android use the same format, so you can typically export a configured Wi-Fi network from a Windows machine, and import into an MDM to deploy widespread, but also to your Android devices.

This web app makes the job simple - you don't have to do any sort of exports, or use Apple Configurtor - you simply fill out the details, copy the profile to your clipboard, and you can use it however you wish - usually the contents are saved in a format such as wifi.mobileConfig for iOS, or something such as wifi.xml format for Windows & Android.

How does it work?

Back to top

It's a standalone webpage (it does have CSS/JavaScript dependencies - more on this later). None of the information you provide ever leaves your browser. It reads the input that you provide into the fields, and replaces the corresponding fields in the generated profile.

What frameworks are used?

Back to top

  1. Bootstrap 4.4.1 for the CSS framework
  2. jQuery for the data validation / reading / manipulation
  3. Clipboard.js for the "Copy to clipboard" function

Bootstrap and jQuery are loaded from their CDN - the Clipboard.js framework is loaded locally (in the "js" folder) - the source code is simple, I left the line in that you can edit if you simply want a single .html file to use internally.

How do I use it?

Back to top

  • You can simply use the GitHub pages link I have hosted! https://daduckmsft.github.io/WiFiProfileGenerator/
  • Alternatively, you can download everything from here, unzip, and enjoy! Nothing else needed - it should just work.
  • If you want to host the dependencies yourself, you can surely do so, but it's way outside of the scope that I'll cover here!
  • If you simply want a page, without even the clipboard.js local dependency - you can edit the page to load it from the CDN.

Edit the html files for both, and you'll see some lines in the <body> that look like this:

    <!-- Load clipboard.js from local repo -->
    <script src="./js/clipboard.min.js"></script>

You can comment those out, and make it look like the following to use the Clipboard.js CDN:

    <!-- Load clipboard.js from local repo
    <script src="./js/clipboard.min.js"></script>  -->
    <!-- Load clipboard.js from CDN -->
    <script src="https://unpkg.com/clipboard@2/dist/clipboard.min.js"></script>

(If this ever fails, they have CDN providers on their GitHub wiki, found here

Functions

Back to top

I tried to document the functions in a manner that's fairly straightforward, but without some basic knowledge of Object Oriented Programming it might not be very clear. There is more information - you can see more info on them below.

Why?

Back to top

I made this because there used to be a website that allowed you to generate a custom / text-based Wi-Fi profile for iOS devices. Sadly, this no longer exists, and I've made this as it's spiritual successor! Johnathanb, if you're out there, I used your website a lot and was sad to see it was no longer there!

About

Client-side web-app that will generate Android, iOS and Windows profiles in their raw format

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 100.0%