at&t global network client for mac ® user’s guide€¦ · at&t affiliated companies. all...

© 2020 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other AT&T marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Images are shown for illustrative purposes only; individual experience

may vary. This document is not an offer, commitment, representation or warranty by AT&T and is subject to change. Apple, the Apple logo, iPhone, iPad, iPod touch, and iTunes are trademarks of Apple Inc., registered in the U.S. and other countries.

Version 1.7.0

AT&T Global Network Client for Mac ® User’s Guide Version 2.2.0

AT&T Global Network Client for Mac User’s Guide

© 2020 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other AT&T marks contained herein are trademarks of AT&T Intellectual Property and/or

AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Images are shown for illustrative purposes only; individual experience may vary. This document is not an offer, commitment, representation or warranty by AT&T and is subject to change.

Apple, the Apple logo, iPhone, iPad, iPod touch, and iTunes are trademarks of Apple Inc., registered in the U.S. and other countries

Notice

The information in this document is believed to be complete and accurate at the time of publication. However, information is subject to change.

Document revisions

This document is revised and maintained by AT&T Global Network Client Development, AT&T Labs.





Notice...................................................................................................................................................................... 2

Document revisions ................................................................................................................................................. 2

Overview.................................................................................................................................................................. 5

Using This Document ............................................................................................................................................... 5

AT&T Global Network Client Overview ..................................................................................................................... 6

Preparing for Installation .......................................................................................................................................... 6

System Requirements .............................................................................................................................................. 6

Requirements for Installation and Use ..................................................................................................................... 7

Obtaining the AT&T Global Network Client ............................................................................................................... 7

Installation ............................................................................................................................................................... 8

Upgrading Previous Releases ................................................................................................................................... 8

Installation .............................................................................................................................................................. 8

Client....................................................................................................................................................................... 8

Installation Package ................................................................................................................................................ 8

Connecting to the Network .................................................................................................................................... 11

Starting the AT&T Global Network Client ............................................................................................................... 11

Connecting ............................................................................................................................................................ 11

Token Authentication ............................................................................................................................................ 13

Software Token Authentication ............................................................................................................................. 14

Generic Challenge/Response Authentication ......................................................................................................... 15

Connected ............................................................................................................................................................. 15

Network Awareness .............................................................................................................................................. 16

Disconnect............................................................................................................................................................. 16

Connecting to a Specific Type of Network .............................................................................................................. 17

Wi-Fi Connections .................................................................................................................................................. 18

Associating to a Specific Wi-Fi Hotspot .................................................................................................................. 18

VPN Connections.................................................................................................................................................... 20

VPN Security Banner .............................................................................................................................................. 20

Auto Reconnect...................................................................................................................................................... 21

Auto Reconnect User Overrides ............................................................................................................................. 22





Maintenance and Support ...................................................................................................................................... 23

Software Updates .................................................................................................................................................. 23

Settings .................................................................................................................................................................. 24

Profile Management .............................................................................................................................................. 24

Overriding Service Manager Auto Proxy Settings ................................................................................................... 24

Customer Service ................................................................................................................................................... 25

Product Logs .......................................................................................................................................................... 26

Uninstall ................................................................................................................................................................. 27

Connecting Without Saving to Keychain ................................................................................................................. 28





Overview The AT&T Global Network Client is a program that enables your Mac OS ® X computer to easily connect to the Internet and your company’s private network.

Using This Document

This document is intended for all users of the AT&T Global Network Client for Mac as a tool to understand the basic function and configuration of the client.

The reader is assumed to have basic knowledge of Mac OS X and computer networking.

This document may refer you to your Help Desk or Customer Account Administrator for additional help on various topics. Your Customer Account Administrator is an employee at your company who can provide you with additional support and is usually a technical resource for your company.





AT&T Global Network Client Overview The AT&T Global Network Client for Mac is software that is designed to allow Mac OS devices to easily access the Internet and your company’s private network from many locations around the world. It provides a simple, powerful interface that detects and connects over cellular, Wi-Fi, and broadband networks. It also provides in-depth diagnostic logging.

Preparing for Installation

System Requirements

The AT&T Global Network Client for Mac and its components are supported on the following operating systems and hardware. (The AT&T Global Network Client has not been formally tested on other operating systems and lesser hardware):

Operating System Hardware

Mac OS 10.14 or later

Administrator Rights Required: The user must have Mac OS administrator rights when the installation is

executed.

80 MB free disk space

Wi-Fi connection: wireless adapter





Requirements for Installation and Use Before starting the AT&T Global Network Client for Mac installation and setup, verify you have the information required in the following checklist. If you are missing any information, please contact your Customer Account Administrator.

Mac OS administrator rights to install or upgrade

Hardware/Equipment necessary to establish basic network connectivity. For example, an existing Internet connection via cable or DSL, Wi-Fi.

For credential driven connections:

Account

User ID

Password

Obtaining the AT&T Global Network Client The AT&T Global Network Client can be downloaded from the public Internet (URL listed below). If you have previously installed the AT&T Global Network Client from a private FTP/Intranet download location, you may be using a custom version of the AT&T Global Network Client; contact your Customer Account Administrator to request an updated version.

Package Download

Client Package http://www.corp.att.com/agnc/mac

Figure 1: Download Location Table





Installation Upgrading Previous Releases

If you already have the AT&T Global Network Client for Mac installed on your workstation it will be uninstalled during the upgrade. Your profiles will be saved during an upgrade.

Installation

Begin the installation by double-clicking on the installation package on your installation media (USB drive, software download, etc.).

Client Installation Package

AT&T Global Network Client for Mac agnc_mac.pkg

Figure 2: Installation Package File Name

Step 1

Click Continue on the Introduction window to continue.

Figure 3: Installation Introduction Window





Step 2

You must agree to the License Agreement to continue. Click Continue and Agree to the terms and conditions.

Step 3

Select the disk where you would like to install the AT&T Global Network Client and click Continue.

Step 4

The installation will display how much disk space is required for the installation and provides an opportunity to change it prior to installing. Click Install to begin the installation.

Figure 4: License Agreement Window

Figure 5: Select Destination

Figure 6: Installation Type





Step 5

Enter your local Mac OS administrator Name and Password to authorize the installation. If you are unsure of the credentials or do not have the required permissions, contact your Customer Account Administrator. Click Install Software to continue.

When the installation has completed, you will see a dialog to let you know that your computer must be restarted in order for the AT&T Global Network Client to be ready to use. Click Restart in order to restart your workstation.

Figure 7: Installation

Figure 8: Installation Complete





Connecting to the Network

Most users are able to establish a connection with no manual configuration prior to their first connection. The AT&T Global Network Client is designed to include an Automatic Connection feature which will attempt a connection over the possible network types installed on your computer.

Starting the AT&T Global Network Client

To launch the AT&T Global Network Client open the Launchpad and click the AT&T Global Network Client icon.

Connecting

Step 1

To connect, click the big green Connect button on the Main Window or click on the Connect button underneath the method desired, e.g. Wi-Fi.

Figure 9:

AT&T Global Network Client Icon

Figure 10: Main Window

Figure 11: Wi-Fi Connect Button





Step 2

The first time you connect the AT&T Global Network Client will prompt you to enter your Account, User ID, and Password. Select the Service you wish to use to connect. This information should have been provided to you by your company’s Customer Account Administrator. If you are unsure of the type of service, please check the Default Service, which allows you to connect desired service.

IPSec VPN Tunnel – This option will allow you to connect to your company’s private network over an existing broadband connection, over an AT&T Wi-Fi or AT&T partner Wi-Fi hot spot.

Default Service – If you are not sure, what your ID is configured for, please select the Default Service, which allows you to connect to the desired service.

Figure 12: Initial Profile Creation





Step 3

After you click OK and your profile has been created, you will be prompted for the password you will use to connect. The password prompt dialog also allows you to change the profile you are going to use to connect if you have multiple profiles defined. Enter your password in the Password field and click OK to begin the connection.

Token Authentication

If you are using an authentication type which requires a PIN and token, enter your PIN immediately followed by the current token in the Password field.

If your token is in the New PIN state when you initiate the connection, the AT&T Global Network Client has been designed to prompt you to enter your new PIN.

If your token is in the Next Card Code required state when you initiate the connection, the AT&T Global Network Client has been designed to prompt you for your next card code after you have successfully authenticated using your current PIN and token.

Figure 13: Prompt for Password

Figure 14: Prompt for New PIN Figure 15: Prompt for Next Card Code





Software Token Authentication

If the RSA SecureID Software Token Authenticator is installed, the AT&T Global Network Client will recognize it and issue a prompt asking if the Software Token should be used for authentication.

If the answer is “Yes”, the credentials screen will prompt you to enter your PIN to authenticate. The AT&T Global Network Client will automatically obtain the token code during authentication using the PIN you entered.

Figure 16: Prompt for Next Card Code

Figure 17: Prompt for PIN.





Generic Challenge/Response Authentication

The AT&T Global Network Client includes support for generic challenge/response authentication, in addition to the New PIN and Next Card Code challenge/response scenarios. This support is useful if your company uses one of a variety of challenge/response authentication methods, including “bingo” cards and the like. Generic challenge/response support requires the appropriate configuration in the AT&T authentication server. When properly configured, the AT&T Global Network Client will display the challenge text from your company’s authentication servers and provide you the opportunity to enter the appropriate response to complete the authentication.

Connected

Included on the Main Window when connected are details on the current connection including the current connection media and the bytes sent and received in the last second.

Figure 19: Main Window Connected

Figure 18: Generic Challenge/Response





Network Awareness

The Customer Account Administrator should detect which networks are currently available and will enable and disable the connection panels appropriately. The Connect button is programmed so you can still attempt to connect, even if the AT&T Global Network Client does not recognize an existing connection.

Disconnect

To end your session click the orange Disconnect button on the Main Window.

Figure 20: Main Window: Network Awareness

Figure 21: Disconnect





Connecting to a Specific Type of Network

In general, simply clicking the main Connect button on the main window of the AT&T Global Network Client will connect you to your network using the best connectivity option available. However, there may be times when you wish to connect to a specific network, instead of letting the AT&T Global Network Client determine the best network option.

If you wish to connect using a specific type of network, just click the Connect button in the connectivity type panel for the connectivity type you want to use. For Wi-Fi connections, all hot spots in the area that can be detected will be listed, along with an indication of what type of hot spot each one is.

Figure 22 Connecting Directly Using Cellular





Wi-Fi Connections The AT&T Global Network Client is designed to support connections to both public and private Wi-Fi hotspots. If wireless is enabled on your workstation, the Wi-Fi panel will be enabled on the Main Window of the client.

By default, if there is no Ethernet connection currently available, the AT&T Global Network Client should automatically attempt to connect to an AT&T Wi-Fi or partner Wi-Fi hotspot nearby. The AT&T Global Network Client should attempt to connect using the AT&T Wi-Fi or partner Wi-Fi hotspot with the strongest signal strength first. It should then try other hotspots in order of signal strength if the previous connection attempt fails.

Associating to a Specific Wi-Fi Hotspot

If you would like to connect to a specific nearby hotspot for some reason, such as if there is no AT&T Wi-Fi or partner Wi-Fi hotspot nearby, or if you know that one of the nearby hotspots is working better than the default selection for some reason, you can pick which hotspot you wish to connect to by clicking on the Connect button in the Wi-Fi panel. You will then be shown a list of all the nearby hotspots. The currently available AT&T Wi-Fi and partner Wi-Fi hotspots will be displayed at the top of the dialog. Other available hot spots will be displayed at the bottom.

If you select one of the AT&T Wi-Fi or partner Wi-Fi hotspots and click the Connect button on this dialog, the AT&T Global Network Client will associate to the selected hotspot and perform the necessary authentication to establish your connection. If you are using a VPN account, the AT&T Global Network Client will also download your VPN configuration from the network and configure and establish your VPN connection for you at the same time.

If you select one of the other available hotspots, and if that hotspot is not encrypted, the AT&T Global Network Client will attempt to associate to the hotspot for you. If you are using a VPN account, after the association is complete, the

Figure 23: Main Window Wi-Fi Enabled





AT&T Global Network Client will prompt you for your password. After you enter your password, the AT&T Global Network Client will attempt to download your VPN configuration from the network and configure and establish your VPN connection for you.

If you select an available hotspot that is encrypted, the AT&T Global Network Client will prompt you for the Passphrase for that hotspot. After you enter the required login information for the hotspot and click OK the AT&T Global Network Client will attempt to associate to the hotspot, using the information you provided in this authentication attempt. If successful, and if you are using a VPN account, the AT&T Global Network Client should then prompt you for your VPN password. After you enter your password, the AT&T Global Network Client will attempt to download your VPN configuration from the network and configure and establish your VPN connection for you.

Figure 24: Select Wi-Fi Hotspot





VPN Connections If you are using a VPN service, after you have entered your credentials and the AT&T Global Network Client has set up any necessary Internet connection, the AT&T Global Network Client will download your VPN configuration from the network and configure and establish your VPN connection for you at the same time.

VPN Security Banner

Most VPN services require you comply with rules and regulations of the service. Before you can use your connection you must click OK on the Security Banner agreeing to the terms and conditions outlined by your company. Click Disconnect on the Security Banner to terminate your connection. Refer all questions about the terms and conditions outlined in your security banner message to your Customer Account Administrator.

Figure 25: Security Banner





Auto Reconnect The Auto Reconnect feature offers a more seamless user experience by keeping you connected with minimal user interaction. The client will attempt to automatically connect or reconnect to the network whenever possible. Listed below are some use cases:

You launch the client and your session token is not expired or you are using saved credentials. The client will automatically attempt to connect to the network without any user.

You are traveling from one location to another. The client is running when you close your laptop while in transit. You re-open your laptop after arriving at your destination. The client will automatically reconnect.

Network roaming. The client will automatically reconnect over another available network connection if the previous network connection is lost, regardless of connection type (Wi-Fi, Ethernet, Mobile).

The Auto Reconnect feature is enabled by default for all users. If it is not enabled, your Administrator may have disabled this feature.





Auto Reconnect User Overrides

If your administrator has granted access, you can modify Auto Reconnect settings. The following settings can be modified by selecting “Auto Reconnect Options” on the “Profiles” screen:

Override Defaults – Selecting this checkbox allows you to use Auto Reconnect settings that are different than your administrator’s default settings.

Automatically reconnect – Enables/Disables the Auto Reconnect feature.

Switch to attwifi or partner hotspot when in range – Enables/Disables the Auto Switch Wi-Fi feature.

Time before switching – Number of seconds the client should wait before switching to Wi-Fi when a hotspot has been detected. The purpose of this setting is to prevent the client from repeatedly prompting you if hotspots are coming in range, but only momentarily.

Minimum signal strength – Minimum hotspot signal strength required for the client to switch the connection from the mobile network to Wi-Fi.

Prompt before switching to Wi-Fi – When this checkbox is enabled, you will be prompted before the client switches your network connection. This gives you the opportunity to selectively utilize the Auto Switch Wi-Fi feature. If disabled, the client will automatically switch to Wi-Fi when the hotspot is in range, without prompting you.

Figure 26: Profile Settings

Figure 27: Auto Reconnect Options





Maintenance and Support

Software Updates

To manually initiate a check for updates, click on the Maintenance & Support icon on the top of the AT&T Global Network Client and select the Product Updates tab. You will not be automatically notified of new updates.

Click the Check for Available Updates button to initiate a check for an updated Hotspot Directory. If an update is available, the Update button will become enabled. Click the Update button to download and install the updated Hotspot Directory.

Figure 29: Software Updates Figure 28: Update Available





Settings Your Customer Account Administrator has preconfigured your network settings in a central AT&T network server. When you connect to the AT&T Global Network, the AT&T Global Network Client should retrieve those settings and apply them to your connection.

Profile Management

The AT&T Global Network Client stores user information in profiles.

A profile includes:

Profile Name

Account

User ID

Service

Most users connect with the same information a majority of the time and will only require one profile.

If you connect with different user IDs or services you may want to define profiles for your common combinations to easily switch between them. The AT&T Global Network Client profiles can be assigned common names to help you remember when to use them, for example, "My Internet Profile" or "VPN Servers - Germany".

Overriding Service Manager Auto Proxy Settings

If you want to add your own Auto proxy settings, We have added fields, one takes the auto proxy URL and the other one IP address and the port number.





Once done entering the proxy settings hit save proxy. You will be notified about the savings.

Note: Settings will be effective only if the client is in disconnect state and only give Auto Proxy URL or Proxy server not both at a time.

Customer Service

If you need to contact the help desk for assistance with the AT&T Global Network Client you can find the help desk phone number for your country by clicking Maintenance & Support and selecting the Customer Svc. Tab. Select your country from the dropdown list and the help desk phone numbers for your country will be displayed. All countries have help desk staff that speak both the local language and English. You should call the phone number for the country to which you are trying to connect.





Product Logs

When working with the help desk, the help desk representatives may want to see logs from the AT&T Global Network Client. To access the logs, click Maintenance & Support and select the Product

Logs tab. You will be able to zip the logs into a single archive to share with the help desk. There is also an option to upload the log files to the help desk.

Figure 31: Product Logs

If you have been instructed to upload the log files, you will be prompted with the Upload Logs window. Please enter the required First Name, Last Name, and help desk Ticket

Number. In the Problem Description field please provide the steps taken to create the problem along with any other specific details that will help troubleshoot the problem. An optional Reference Code can be provided for your own tracking purposes. Click Submit to send the log files to the help desk after filling in your information.

Figure 30: Customer Service





Figure 32: Upload Logs

Uninstall The AT&T Global Network Client is removed via the AT&T Global Network Client Uninstaller icon in the Launchpad.

Figure 33: Uninstall Icon in Launchpad

Step 1

Click AT&T Global Network Client Uninstaller.

Step 2

Click the Uninstall button on the AT&T Global Network Client Uninstaller.

Step 3

You will be prompted for your Mac OS administrator password for your computer in order to complete the removal of the AT&T Global Network Client will. Click OK to proceed with the uninstall.

The removal of the AT&T Global Network Client will complete silently. No additional prompts will be displayed.

Figure 35: Uninstaller Permission Prompt

Figure 34: AT&T Global Network Client Uninstaller





Connecting Without Saving to Keychain The AT&T Global Network Client performs network configuration tasks that require administrative privileges at connect and disconnect time. Therefore, by default, the AT&T Global Network Client will create a keychain entry using your MAC OS X username and password, so that you are not prompted every time the AT&T Global Network Client connects or disconnects. If you prefer to use the AT&T Global Network Client without creating a keychain entry, deselect the “Save username and password in Keychain” checkbox.

You will be presented with MAC OS X prompts if those credentials are needed to connect or disconnect you from the network.

at&t global network client for mac ® user’s guide€¦ · at&t affiliated companies. all...

Documents