COSA/APN database

Windows 8, Windows 8.1, and Windows 10 include an APN database that is used by Windows networking components, such as the Windows Connection Manager, to provide a seamless connection experience for end users by supplying and trying available connection APNs based on the user’s mobile broadband device. The APN database contains the information needed to connect to the mobile broadband network, allowing Windows to connect automatically with minimal user input. The database maintains access strings for different mobile network operators, enabling a user’s connection to the operator’s network prior to acquiring any additional software or metadata. For example, a user can get connected without having a mobile broadband app installed.

In addition to provisioning information, the database also includes a URL to the account experience website. After automatically connecting to the operator’s network, the account experience website opens in the default browser, where the user can purchase a subscription or one-time access.

Important

Starting in Windows 10 Version 1703, the APN database is replaced by a new format called COSA. Windows 8, Windows 8.1, and versions of Windows 10 before Version 1703 will continue to use the APN database while Windows 10 Version 1703 and later use COSA. For a list of frequently asked questions about COSA, see COSA FAQ.

APN database contents

To connect to a mobile broadband network, the user typically provides the following information:

  • In Global System for Mobile Communications (GSM) networks, an APN such as data.contoso.com.

  • In CDMA networks, an access string that includes a special dial code such as #777, or a Network Access Identifier (NAI) such as ann@contoso.com.

  • The user’s credentials (username and password) for the network connection.

Specifically, the APN database includes the following data:

  • Operator identification data

    • For a GSM network, you can submit database entries for the International Mobile Subscriber Identity (IMSI) or Integrated Circuit Card Identifier (ICCID) ranges that your network uses. If you are a mobile virtual network operator (MVNO), you can specify one or more ranges of IMSIs or subscriber identification module (SIM) ICC IDs that you leased from a mobile network operator (MNO).

    • For CDMA networks, you can submit new database entry for each Provider ID or Provider Name.

    • To better understand how you can identify MVNOs, see Delivering experiences for MVNOs.

  • List of purchase APNs and access strings

    • For a GSM network, a list of APNs that have a username and password to purchase the subscription.

    • For a CDMA network, a list of NAIs to purchase the subscription.

  • List of Internet connect APNs and access strings

    • For a GSM network, a list of APNs that have a username and password to connect to the Internet.

    • For a CDMA network, a list of NAIs that are used to connect to the Internet.

  • Account Experience URL URL for a first-time purchase account experience web site.

  • Certificate Data Certificate information for account provisioning metadata. This includes Certificate Issuer Name and Subject Name, and is used to verify that Account Provisioning that is provided by a purchase web site comes from the user’s authorized web service.

For more information on the APN database XML schema, see APN database schema reference.

APN database submission and maintenance

If you want to request a new APN or update an existing one, see APN database submission.

Send comments about this topic to Microsoft