Data Packages¶
The Data Packages page manages TAK data packages — bundled configuration files that TAK clients import to connect to the MAGK platform. Data packages simplify client setup by packaging certificates, server addresses, and connection settings into a single downloadable file.
Data Package Contents¶
A standard MAGK data package contains:
| File | Description |
|---|---|
Client Certificate (.p12) | Player's client certificate and private key in PKCS#12 format |
CA Certificate (.pem) | TAK CA root certificate for server verification |
Server Preferences (.pref) | TAK server connection settings (address, ports, protocol) |
Manifest (.xml) | Package manifest listing all included files |
The package is delivered as a .zip file that TAK clients (ATAK, iTAK, WinTAK) can import directly.
Creating a Data Package¶
Click Create Package to generate a new data package.
Form Fields¶
| Field | Type | Required | Description |
|---|---|---|---|
| Player | Select | Yes | Player to generate the package for |
| Certificate | Select | Auto | Client certificate to include (auto-selects the player's active certificate, or issues a new one) |
| Server Address | Text | Auto | TAK server address (auto-populated from platform settings) |
| SSL Port | Number | Auto | SSL CoT port (default: 8089) |
| TCP Port | Number | Auto | TCP CoT port (default: 8087) |
| Include CA | Toggle | Yes | Include the TAK CA certificate in the package |
Auto-Generation
When a player's registration is approved, MAGK can automatically generate and assign a data package. Enable this in the event's Registration settings.
Package List¶
| Column | Description |
|---|---|
| Player | Associated player name and callsign |
| Created | Package generation date |
| Certificate | Included certificate common name |
| Downloaded | Whether the player has downloaded the package |
| Status | Active or Expired (based on certificate validity) |
Distribution¶
Data packages can be distributed to players in several ways:
| Method | Description |
|---|---|
| Download Link | Player downloads the package from their profile page or the registration confirmation |
| QR Code | Generate a QR code linking to the package download URL |
| Send the package as an email attachment (requires SMTP configuration) | |
| Bulk Download | Download all packages for an event as a single archive |
Player Self-Service¶
Approved players can download their data package from:
- The registration confirmation page after approval
- Their profile page under Devices → Download Data Package
- The event detail page under My Connection
Bulk Operations¶
For events with many participants, use bulk operations:
- Navigate to Data Packages → Bulk Actions
- Select the event
- Choose an action:
- Generate All — Create data packages for all approved players who don't have one
- Download All — Download a ZIP archive containing all packages for the event
- Regenerate All — Regenerate packages for all players (e.g., after server address change)
Package Contents Detail¶
Server Preferences File¶
The .pref file configures the TAK client's server connection:
<preferences>
<preference version="1" name="cot_streams">
<entry key="connectString0" class="class java.lang.String">
magktech.com:8089:ssl
</entry>
<entry key="description0" class="class java.lang.String">
MAGK Server
</entry>
</preference>
</preferences>
Server address and ports are populated from the platform's TAK service configuration.
Related Pages¶
- Certificates — Certificate generation and management
- Registrations — Auto-generation on registration approval
- Federation — Federated server data packages
- Settings — TAK server address and port configuration