User Guide

Understanding User Roles

The 44Net Connect PoP Controller has different user types with varying permissions. Below are the roles you currently have:

Regular User

• Can create an account and login
• Can view their account information
• Cannot request resources until email is verified

Requesting a Tunnel

A tunnel is a point-to-point connection between your device/network and a 44Net Connect Point of Presence (PoP).

This is the primary way most users connect to the network.

Prerequisites

• Verified email address (see Getting Started)
• WireGuard installed on your device or network

Step 1: Navigate to Request a Tunnel

1. Click "My Resources" in the sidebar
2. Click "Tunnels"
3. Click the "Request Tunnel" button
4. Click the PoP Node/Location that you want tunnel connected

Step 2: Fill Out the Request Form

1. Tunnel Name: Give your tunnel a descriptive name (e.g., "Home Lab Connection")
2. Create Preshared Key (optional): Select the rotation icon to create new preshared key
3. Routing Selection (optional): Select Routing Static and Choose which network(s) this tunnel will include
4. Email (optional): Check the box "Send tunnel details by email" if you want to be emailed the configuration.
5. Click "Create Tunnel"

Step 3: Setup Configuration

After the tunnnel is created, you will be given preformated configurations that you can place in your wireguard config.

1. The configurations are located in tabs for each tunnel

Requesting Networks and ASNs

If you need your own network allocation or Autonomous System Number (ASN), you can submit a request.

Requesting a Network Allocation

1. Click "My Resources" → "Networks"
2. Click "Request Network"
3. Provide:
   • Network Name: Description of your network
   • Network Type: Choose allocation type (auto-assigned or bring-your-own)
   • Network Size: How many IP addresses you need
   • Justification: Why you need this network
4. Click "Submit Request"

Requesting an ASN

1. Click "My Resources" → "ASNs"
2. Click "Request ASN"
3. Provide:
   • ASN Justification: Explain why you need your own ASN
   • Intended Use: BGP routing, network advertising, etc.
4. Click "Submit Request"

Tracking Your Requests

1. Click "My Resources" → "My Requests"
2. View all your submitted requests
3. Check the status: Pending, Approved, or Denied

Network Topology Visualization

View your connections and the 44Net Connect infrastructure network map.

Viewing Your Network (My Network)

1. Click "Network Tools" → "My Network"
2. You'll see a visual map of:
   • Your tunnels and their connection status
   • The PoP nodes you're connected to
3. Click on nodes to see more details

Viewing Full Infrastructure (Admin Only)

Administrators can view the complete network infrastructure:

1. Click "Network Tools" → "Full Topology"
2. See all PoPs, nodes, and network connections
3. Monitor network status and capacity

Managing API Keys

API keys allow you to programmatically access the 44Net Connect system for automation and integration with your tools.

Creating an API Key

1. Click your username in the top right → "API Keys"
2. Click "Add API Key"
3. Provide:
   • Key Name: A descriptive name for this key
   • Expiry Date: Optional expiration date for the key
4. Click "Create"
5. Copy and store the token securely (you won't see it again!)

Using Your API Key

Include your API key in HTTP requests using HTTP Basic Authentication with your username and API key:

curl -u "YOUR_USERNAME:YOUR_API_KEY" http://localhost/api/v1/tunnels

If using a self-signed certificate (development), add the -k flag:

curl -k -u "YOUR_USERNAME:YOUR_API_KEY" http://localhost/api/v1/tunnels

Managing Existing Keys

1. Go to "API Keys" section in your account
2. View all your active keys
3. Regenerate keys to invalidate old ones
4. Delete keys you no longer need

IP Address Lookup

The system provides a simple API endpoint to check your current public IP address as seen by the server. This is useful for troubleshooting, verifying your network configuration, or checking if you're connected through a VPN.

Using the Web Interface

When you're logged in, your current IP address is displayed at the bottom of every page in the footer:

Using the API Endpoint

You can also check your IP programmatically using the /myip endpoint. No authentication required.

Basic Usage

Get your IP address as JSON:

curl https://connect.44net.cloud/myip

Response:

{
  "ip": "203.0.113.45"
}

Extract Just the IP Address

If you have jq installed, you can extract just the IP:

curl -s https://connect.44net.cloud/myip | jq -r '.ip'

Response:

203.0.113.45

Use in Scripts

Store your IP in a shell variable:

MY_IP=$(curl -s https://connect.44net.cloud/myip | jq -r '.ip')
echo "My IP is: $MY_IP"

Common Use Cases

• VPN Verification: Check if your VPN is working by comparing IPs before and after connecting
• Dynamic DNS Updates: Automatically update your DNS records with your current IP
• Firewall Configuration: Determine your IP to whitelist in firewall rules
• Network Troubleshooting: Verify you're accessing the service from the expected IP
• Automation Scripts: Use in scripts that need to know the current public IP

Technical Notes

• The endpoint handles proxy headers (X-Forwarded-For, X-Real-IP) correctly
• IPv4-mapped IPv6 addresses (e.g., ::ffff:192.0.2.1) are automatically converted to IPv4 format
• No rate limiting is applied to this endpoint
• No authentication required - accessible to anyone

Downloading WireGuard Configurations

Once your tunnel is approved, you need to download the WireGuard configuration to connect.

Method 1: Download Configuration File

1. Go to "My Resources" → "Tunnels"
2. Click on your tunnel
3. Scroll to the "Configuration" section
4. Click "Download Config" or copy the config text
5. Save as a .conf file
6. Import into your WireGuard application

Method 2: QR Code (Mobile)

1. Go to your tunnel details page
2. Look for "QR Code" section
3. Open WireGuard app on your phone
4. Tap "+" and select "Scan from QR Code"
5. Scan the displayed QR code
6. Tap "Add Tunnel"

Sample WireGuard Configuration

Your downloaded config will look similar to this:

[Interface]
PrivateKey = your-private-key-here
Address = 44.190.40.10/24
DNS = 1.1.1.1

[Peer]
PublicKey = server-public-key
Endpoint = 203.0.113.1:51820  # Update with PoP node's IP
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25

Connecting

1. Desktop: Open WireGuard app → Select your config → Click "Activate"
2. Mobile: Open WireGuard app → Tap your tunnel → Toggle the switch
3. Status will change from "Inactive" to "Active" when connected

Troubleshooting

Connection Issues

Getting Additional Help

• Check Status: Go to "My Resources" → "My Requests" to see any error messages
• Review Logs: Check WireGuard app logs for connection errors
• Contact Administrator: Reach out to your network administrator if issues persist
• WireGuard Docs: Visit wireguard.com for general WireGuard help