View source for Configuring Raspberry Pi access for eduSTAR on School Networks

= Connecting to a Secure WiFi Network using WPA2 enterprise=

Connecting a headless Raspberry Pi to a secure local network using WPA2 Enterprise involves a few steps. Here, I'll outline the general process. Please note that specific details might vary depending on your network configuration and the version of the Raspberry Pi operating system you're using.

* '''Headless Setup:''' Ensure that your Raspberry Pi is set up for headless operation. This typically involves creating an empty file named ssh in the boot partition to enable SSH.

* '''Network Information:''' Obtain the necessary information for connecting to the WPA2 Enterprise network, including the SSID, security method (WPA2 Enterprise), the EAP method (e.g., PEAP), identity, and password.

* '''Connect to Raspberry Pi:''' Connect your Raspberry Pi to your computer via an Ethernet cable or insert the SD card into a card reader.

* '''Power Up Raspberry Pi:''' Power up the Raspberry Pi.

* '''Find Raspberry Pi IP Address:''' Determine the IP address assigned to your Raspberry Pi. You can use a tool like Angry IP Scanner or check your router's DHCP client list.

* '''SSH into Raspberry Pi:''' Open a terminal on your computer and use SSH to connect to the Raspberry Pi. Replace <Raspberry Pi IP Address> with the actual IP address of your Raspberry Pi.

<syntaxhighlight lang="bash">
ssh pi@<Raspberry Pi IP Address>
</syntaxhighlight>

* '''Edit Network Configuration:''' Edit the wpa_supplicant configuration file. Use a text editor like nano or vi:
<syntaxhighlight lang="bash">
sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
</syntaxhighlight>

* Add the following lines to configure WPA2 Enterprise. Replace <Your SSID>, <Your Identity>, and <Your Password> with your network's SSID, identity, and password.

<syntaxhighlight lang="bash">
network={
    ssid="<Your SSID>"
    key_mgmt=WPA-EAP
    pairwise=CCMP TKIP
    group=CCMP TKIP
    eap=PEAP
    identity="<Your Identity>"
    password="<Your Password>"
    phase1="peapver=0"
    phase2="MSCHAPV2"
}
</syntaxhighlight>

* '''Save and Exit:''' Save the changes and exit the text editor.

* '''Restart Networking Service:''' Restart the networking service to apply the changes:

<syntaxhighlight lang="c++">
sudo systemctl restart networking
</syntaxhighlight>

* '''Check Connection:''' Wait for a moment and then check if your Raspberry Pi has successfully connected to the network:

<syntaxhighlight lang="c++">
ping google.com
</syntaxhighlight>

That's it! Your headless Raspberry Pi should now be connected to the WPA2 Enterprise network. Adjust the configuration details as needed based on your specific network settings.

== phase1 and phase2 ==

In the context of configuring WPA2 Enterprise on a Raspberry Pi, the phase1 and phase2 parameters in the wpa_supplicant.conf file are used to specify the Phase 1 and Phase 2 authentication methods during the Extensible Authentication Protocol (EAP) process.

Let's break down the specific values you mentioned:

* '''phase1="peapver=0":''' peapver=0 indicates that the Protected Extensible Authentication Protocol (PEAP) version 0 should be used. PEAP is an EAP protocol that encapsulates the EAP conversation in a TLS tunnel, providing a secure method for authentication.

* '''phase2="MSCHAPV2":''' MSCHAPV2 stands for Microsoft Challenge Handshake Authentication Protocol version 2. It is a commonly used authentication protocol that enables secure communication between a client and a server. In the context of WPA2 Enterprise, it is often used as the inner authentication method within the PEAP tunnel.

In summary, these settings specify that PEAP version 0 should be used for the outer authentication, and within that PEAP tunnel, MSCHAPV2 should be used for the inner authentication. These settings are common for WPA2 Enterprise networks that use PEAP with MSCHAPV2 for user authentication. The specific authentication methods can vary depending on the security policies of the network you are connecting to.

= Proxy for WPA2 enterprise =

Configuring a proxy for WPA2 Enterprise on a Raspberry Pi involves additional steps beyond the typical WPA2 Enterprise setup. The process usually requires configuring proxy settings for the operating system or specific applications that need internet access. Here's a general guide on how you can set up a proxy on a Raspberry Pi via the command line:

* '''Identify Proxy Settings:''' Contact your network administrator or check network documentation to obtain the proxy settings, including the proxy address and port.

* '''Set Proxy for the Entire System:''' Edit the system-wide environment variable to set the proxy. Open the /etc/environment file using a text editor:

<syntaxhighlight lang="bash">
sudo nano /etc/environment
</syntaxhighlight>

* Add the following lines, replacing <proxy_address> and <proxy_port> with your actual proxy server details. Save the file and exit.

<syntaxhighlight lang="bash">
http_proxy=http://<proxy_address>:<proxy_port>/
https_proxy=https://<proxy_address>:<proxy_port>/
</syntaxhighlight>


* '''Apply Changes:''' Restart the networking service to apply the changes:

<syntaxhighlight lang="bash">
sudo systemctl restart networking
</syntaxhighlight>

* '''Configure APT for Package Manager:''' If you're using APT for package management, you may need to configure it to use the proxy. Open the APT configuration file:

<syntaxhighlight lang="c++">
sudo nano /etc/apt/apt.conf
</syntaxhighlight>

* Add the following line, replacing <proxy_address> and <proxy_port> with your proxy server details. Then Save the file and exit.

<syntaxhighlight lang="c++">
Acquire::http::Proxy "http://<proxy_address>:<proxy_port>/";
</syntaxhighlight>


* '''Configure Proxy for Specific Applications:''' Some applications, like web browsers, may have their own proxy settings. For example, for wget. Adjust configurations for specific applications as needed.

<syntaxhighlight lang="c++">
echo "export http_proxy=http://<proxy_address>:<proxy_port>/" >> ~/.bashrc
source ~/.bashrc
</syntaxhighlight>


* '''Test Proxy Connection:''' You can test the proxy connection using curl or wget. For example:

<syntaxhighlight lang="c++">
curl https://www.example.com
</syntaxhighlight>

* '''Important Note:''' Proxy configurations can vary depending on the specific proxy server and network requirements. Always consult with your network administrator or refer to network documentation for accurate proxy settings.

* Adjust the instructions based on your specific proxy configuration and Raspberry Pi OS version. Keep in mind that proxy configurations are often specific to the applications you are using, and not all applications may respect the system-wide proxy settings.

== source ~/.bashrc ==

In Linux, the source command is used to execute commands from a file, and when you run source ~/.bashrc, you are essentially executing the commands in the .bashrc file for the current shell session.

Here's what happens in more detail:

* '''.bashrc file:''' The '''~/.bashrc''' file is a script that is executed whenever a new interactive shell session is started. It typically contains commands to set environment variables, define aliases, and perform other customizations for your shell environment.

* '''source command:''' The '''source''' command (or its equivalent, .) is used to execute the commands in a specified file within the current shell session. When you run '''source ~/.bashrc''', you are telling the shell to read and execute the commands from the '''.bashrc''' file in the user's home directory.

* '''Effects on the current shell session:''' By sourcing '''.bashrc''', any changes or additions made in that file, such as new environment variables or custom commands, will take effect in the current shell session. This is particularly useful when you make changes to your '''.bashrc''' file and want those changes to be immediately applied without having to start a new shell session.

So, running '''source ~/.bashrc''' is a way to apply changes made in your '''.bashrc''' file to the current shell session. It is not needed if you start a new terminal session, as the '''.bashrc''' file is automatically executed when a new interactive shell starts.

= Entering a PAC URL =

To use a Proxy Auto-Configuration (PAC) URL on a Linux system, you typically configure it through system-wide environment variables or specific application settings. The PAC file contains JavaScript code that determines which proxy server to use based on various conditions.

A PAC URL, or Proxy Auto-Configuration URL, is a URL that points to a Proxy Auto-Configuration script file. This script, typically written in JavaScript, helps web browsers and other network clients automatically determine the appropriate proxy server to use for a given URL or set of URLs.

Proxy Auto-Configuration scripts provide a way to dynamically manage proxy settings based on conditions specified in the script. The script contains logic that evaluates the requested URLs and decides which proxy server, if any, should be used for each request. This allows for more flexible and dynamic control over proxy configurations in a networked environment.

Here's how you might set a PAC URL in different scenarios:

'''System-wide Environment Variables:''' Edit the /etc/environment file:

<syntaxhighlight lang="bash">
sudo nano /etc/environment
</syntaxhighlight>

* Add the following line, replacing <pac_url> with the actual PAC URL:

<syntaxhighlight lang="bash">
http_proxy=http://<pac_url>
https_proxy=https://<pac_url>
</syntaxhighlight>

Save the file and restart the networking service with the following command:

<syntaxhighlight lang="bash">
sudo systemctl restart networking
</syntaxhighlight>


'''Configure Proxy for APT:''' If you're using APT for package management, configure it to use the PAC URL:

<syntaxhighlight lang="bash">
sudo nano /etc/apt/apt.conf
</syntaxhighlight>

Add the following line, replacing <pac_url> with the actual PAC URL. Save the file.

<syntaxhighlight lang="bash">
Acquire::http::Proxy "http://<pac_url>";
</syntaxhighlight>

'''Configure Proxy for Specific Applications:''' For applications like wget, you can set the proxy in your user's .bashrc file. Adjust configurations for other applications based on their requirements.

<syntaxhighlight lang="bash">
echo "export http_proxy=http://<pac_url>" >> ~/.bashrc
source ~/.bashrc
</syntaxhighlight>

'''Browser Configuration:''' Web browsers often have their own proxy settings. For example, in Firefox:

* Open Firefox and go to Preferences.
* Navigate to the "General" tab.
* Scroll down to the "Network Settings" section.
* Select "Automatic proxy configuration URL" and enter your PAC URL.

'''Important Notes:''' Ensure that your PAC URL is accessible from the Raspberry Pi. 
* The specific steps may vary depending on the Linux distribution and version you are using. 
* Always consult your network administrator or refer to network documentation for accurate proxy settings. 
* Remember to replace <pac_url> with the actual PAC URL provided by your network administrator or service provider.

== Proxy Servers ==
A proxy server is an intermediary server that acts as a gateway between a user's device (such as a computer or smartphone) and the internet. When a user makes a request to access a resource on the internet, the request is first sent to the proxy server, which then forwards the request to the target server. The target server responds to the proxy server, and the proxy server, in turn, forwards the response to the user.

Here are some key purposes and functions of proxy servers:

* '''Anonymity and Privacy:''' Proxy servers can be used to hide the user's IP address from the websites they visit. This provides a level of anonymity and privacy by masking the user's identity.

* '''Content Filtering:''' Organizations often use proxy servers to implement content filtering policies. By analyzing and filtering web traffic, proxy servers can block access to specific websites or content categories, helping enforce acceptable use policies.

* '''Caching:''' Proxy servers can cache frequently requested resources locally. When a user requests a resource, the proxy server checks if it has a cached copy. If so, it can deliver the cached content, reducing the load on the internet connection and speeding up access to frequently visited sites.

* '''Bandwidth Savings:''' By caching and compressing content, proxy servers can reduce the amount of data that needs to be transmitted over the network, leading to bandwidth savings.

* '''Access Control:''' Proxy servers can be configured to control access to the internet. This is commonly used in corporate networks to restrict access to certain websites or types of content.

* '''Security:''' Proxies can act as an additional layer of security by inspecting and filtering incoming and outgoing traffic. They can block malicious content, filter out potential threats, and provide a barrier between internal networks and the internet.