Internet Explorer Administration Kit

.ISP/.INS Reference Guide

There are two different types of files used in the sign-up scenario: the ISP (Internet service provider) file and the INS (InterNet Setup) file. The ISP file contains the information that a computer needs to connect to a Sign-Up Web Server connected to the PSTN (Public Switch Telephone Network). A single .isp file can be used by all computers that want to sign up. The INS file encapsulates the parameters needed to set up Internet access and service for the customer. The INS file is generated dynamically by the Sign-up server as a result of the customer signing up for an account. The .ins file will be unique for all users wanting to sign up. The Microsoft(r) Internet Explorer Administration Kit (IEAK) wizard will enable the ISP to easily generate a large part of the .ins file. Both the ISP and INS file formats are extensions of the Dial-Up Networking file format, which itself is a Microsoft Windows(r) .ini file. The sections which are common are listed below. The Windows .ini files have the following characteristics:

An .ini file is divided into sections. A section heading is identified by its enclosure by square brackets (for example, [Device] is the Device section).
The order of appearance for sections is not important. Therefore a particular section can be placed anywhere in the .ini file.
Sections are delimited by one blank line.
Each section can contain multiple entries.
Each entry is a line of the form "EntryName=EntryValue".
Comments in the .ini file are denoted by starting the comment with an semicolon (;).
For full reference on the .ini file format, see the Microsoft Windows SDK.

Note: To view this document properly, you may have to expand the browser width. You can also close the Table of Contents frame, and then use the Back button to return to it.

[ActiveSetup]

Entry

Value

Notes

Description / Purpose

Active Setup branding section.

WizardBitmap

Path

ex:

Path of bitmap to be displayed on

C:\bitmaps\actsetup.bmp

left-hand side of Active Setup

(??)

install pages.

WizardTitle

text string

ex: Joe's Custom

Window title to be displayed during

Package Setup

Active Setup.

[ActiveSetupSites]

Entry

Value

Notes

Description / Purpose

Section to describe Active Setup

site URLs, names, and regions.

SiteName0

text string

ex: Download Site 0

Friendly name of download site.

SiteNameN

text string

ex: Download Site 9

Friendly name of download site.

N=0à9

SiteRegion0

text string

ex: North America

Region of download site.

SiteRegionN

text string

ex: Asia

Region of download site. N=0à9

SiteUrl0

URL

ex: http://DownloadURL0

Site of first download site.

SiteURLN

URL

ex: http://DownloadURL9

Download site URL. N=0à9

TestCertsOK

1 = Yes / 0 = No

Temporary setting for allowing

Test Certificates to process.

[Animation]

Entry

Value

Notes

Description / Purpose

Animation Section

Big_Name

1 = Yes / 0 = No

Big_Path

1 = Yes / 0 = No

DoAnimation

1 = Yes / 0 = No

DynamicFolder

1 = Yes / 0 = No

Small_Name

1 = Yes / 0 = No

Small_Path

1 = Yes / 0 = No

[Batch]

Entry

Value

Notes

Description / Purpose

Batch install parameters.

Build_CD

1 = Yes / 0 = No

Flag to build CD package.

Build_Floppy

1 = Yes / 0 = No

Flag to build floppy package.

Build_Win31

1 = Yes / 0 = No

Flag to build Win3.1 package.

[Big_Logo]

Entry

Value

Notes

Description / Purpose

Large bitmap logo

text string

ex: "0=begin 666

Line 1 of the uuencoding of the

abc.bmp"

large bitmap used for branding

Internet Explorer.

text string

ex: "1=à"

Line 2 of the uuencoding.

text string

ex: "86=end"

Last line of the uuencoding

[Branding]

Entry

Value

Notes

Description / Purpose

Internet Explorer Branding

Parameters

CompanyName

text string

Company name, for reference

only. Not used in any part of the

user interface.

Custom_Key

text string

OEM customization key that is

assigned by Microsoft.

Global

1 = Yes / 0 = No

0 also equals no group

This is a global .ins file.

or user .ins specification

GUID

Install_Amovie

1 = Yes / 0 = No

Whether to install ActiveMovie™.

Install_ComicChat

1 = Yes / 0 = No

Whether to install ComicChat.

Install_Cust1

1 = Yes / 0 = No

Whether to install Custom

application 1.

Install_Cust2

1 = Yes / 0 = No

Whether to install custom

application 2.

Install_HTMLLayout

1 = Yes / 0 = No

Whether to install HTML Layout

Control.

Install_Mail

1 = Yes / 0 = No

SUBJECT TO CHANGE -

Whether to install Internet Mail.

Internet_News skipped

for now

Install_NetMtg

1 = Yes / 0 = No

Whether to install NetMeeting™.

InstallDir

text string

ex: %p\Internet Explorer

Installation directory for 32-bit

clients.

InstallDir16

text string

ex: %w\IEXPLORE

Installation directory for 16-bit

clients.

PerUserIns

1 = Yes / 0 = No

Specifies if the installation will use

per-user .ins files.

PerUserInsPath

Path

ex: e:\ins

Path to per-user .ins files.

Serverless

1 = Yes / 0 = No

SignupCustomCmd

Command string

Command line to be run on 32-bit

clients after installation

SignupCustomCmd16

Command string

Command line to be run on 16-bit

clients after installation.

SignupCustomDir

Path

Path of the directory that the wizard

used for custom materials (not

used as part of the installation)

UserAgent

Version

Four integers

ex: 1,0,0,18

Branding version number (job

delimited by

number) -- incremented on each

active setup install.

WebIntegrated

1 = Yes / 0 = No

Include Web Integrated Desktop

with install.

Window_Title

text string

ex: "ABC Internet

The name to be shown in the

Explorer"

Internet Explorer title bar.

Wizard_Version

numeric string

string separated by

Internal version number of the

periods

wizard which generated the .ins

file.

[Content]

Entry

Value

Notes

Description / Purpose

Content parameters section.

DoCertificates

1 = Yes / 0 = No

DoPubCertificates

1 = Yes / 0 = No

DoRatings

1 = Yes / 0 = No

[Custom]

Entry

Value

Notes

Description / Purpose

Optional and for ISPs

Custom Settings Description

only

Custom_File

file name

Must be 8.3 to be used

Creates a custom file with the

with Win3.1. This file is

contents shown in the

always placed in the

[Custom_File] section.

Windows directory

[Custom_File]

Entry

Value

Notes

Description / Purpose

Optional and for ISPs

Custom Parameter File

only

text string

ex: "[Section]"

Line 1 of the file

text string

ex: "Value1=ABC"

Line 2 of the file

text string

ex: "Value2=DEF"

Line 3 of the file

[CustomSignup]

Entry

Value

Notes

Description / Purpose

List custom signup files.

file name

ex: 1=cancel.ins

First file name.

file name

ex: 4=signup.isp

Nth file name.

NumFiles

number

Number of files.

[DesktopObjects]

Entry

Value

Notes

Description / Purpose

Desktop objects parameters

section.

GeneralFlags

ImportToolbars

1 = Yes / 0 = No

Flag setting whether to import the

Desktop Toolbars from the current

machine.

LocalHTML

Option

Path0

Path

Zorder

[Entry]

Entry

Value

Notes

Description / Purpose

Cancel

Yes / No

Used to termined

If set to yes, the signup process

ISIGNUP.EXE cleanly

will be stopped, and no Internet

when no configuration is

configuration is to be performed

wanted.

on the client's system.

[ExRegInf]

Entry

Value

Notes

Description / Purpose

TBD

Toolbars

TBD

[Favorites]

Entry

Value

Notes

Description / Purpose

Describe the Favorites to add.

Subdir\URL1

text string

ex: "Cool Sites\Link

Full friendly name pointing to the

Central.url=http://www.m

URL file for a favorites entry. These

sn.com/access/links/oth

entries should be generated by

er.htm"

the IEAK wizard.

Subdir\URL2

text string

Second favorite to create.

[Ie3inst]

Entry

Value

Notes

Description / Purpose

This section is set by the

Private section to be set only by the

IEAK wizard.

wizard.

[Internet_Mail]

Entry

Value

Notes

Description / Purpose

Should be set by ISP or

Describe the POP3/SMTP Setup

corp. admin in

configuring mail.

Settings apply to Win3.1

and Win95. Wizard will

not configure any

settings unless the

wizard has Win95 in the

options for that build.

Domain

ex: "microsoft.com"

Domain name. This will be

overridden by any fully qualified

name that the ISP puts in the .ins

file.

Email_Address

text string

ex: "joeb@aaa.com" -

Return address of the user.

Manual Entry

Email_Name

text string

ex: "Joe B. User" -

The friendly name of the user.

Manual entry

Install_Mail

1 = Yes / 0 = No

Specified whether Internet Mail

should be installed.

POP_Logon_Name

text string

manual entry

POP3 logon name.

POP_Logon_Password

text string

manual entry

POP3 logon password

POP_Server

IP address

ex: "mail.aaa.com"

POP3 server address.

SMTP_Server

IP address

ex: "mail.aaa.com"

SMTP server address

Use_MS_Exchange

Yes / No

If value is true, Internet Setup

installs and uses Exchange as the

SMTP/POP3 email client.

[Internet_News]

Entry

Value

Notes

Description / Purpose

Should be set by ISP or

Describe the NNTP setup.

corporate intranet admin

if configuring mail.

Settings apply to Win3.1

and Win95.

Logon_Required

1 = Yes / 0 = No

Specified whether the user needs

to be logged on to ensure caching

of the password.

NNTP_Logon_Name

text string

manual entry

NNTP logon name.

NNTP_Logon_Password

text string

manual entry

NNTP logon password.

NNTP_Server

IP address

ex: "news.aaa.com"

NNTP server address.

[Proxy]

Entry

Value

Notes

Description / Purpose

This section only applies

Proxy entry description

to corp admins.

FTP_Proxy_Server

IP address

ex: http://proxyserver:80

IP address of FTP proxy.

Gopher_Proxy_Server

IP address

ex: http://proxyserver:80

IP address of Gopher proxy

HTTP_Proxy_Server

IP address

ex: http://proxyserver:80

IP address of HTTP proxy followed

by a colon and the port number.

Proxy_Enable

1 = Yes / 0 = No

Specifies whether the system will

use a proxy server to connect to

the Internet.

Proxy_Override

List of IP address

ex: <local>

List of addresses for which to

bypass proxy, separated by

semicolons; may include the

designation <local>.

Secure_Proxy_Server

IP address

ex: http://proxyserver:80

IP address of secure proxy.

Socks_Proxy_Server

IP address

ex: http://proxyserver:80

IP address of Socks proxy.

Use_Same_Proxy

1 = Yes / 0 = No

Specifies that the same proxy

server will be used for all

protocols. All but the HTTP proxy

addresses are ignored.

[Restrictions]

Entry

Value

Notes

Description / Purpose

corp admin only

User interface restrictions

[Scripting]

Entry

Value

Notes

Description / Purpose

[Security]

Entry

Value

Notes

Description / Purpose

Security paramters section

Code Download

Yes / No

Flag for allowing users to

download code from the internet.

Security_RunActiveXCont

1 = Yes / 0 = No

Allow user to run ActiveX controls.

rols

Security_RunJavaApplet

1 = Yes / 0 = No

Allow user to run Java applets.

Security_RunScripts

1 = Yes / 0 = No

Allow user to run scripts.

[Signature]

Entry

Value

Notes

Description / Purpose

Signature of news postings

sections

Signature_Text

text string

Uses printf style encoding (\n for

new-line, \\ for actual text

backslash)

Use_Signature

1 = Yes / 0 = No

Flag to turn on or off signature

specification.

[Small_Logo]

Entry

Value

Notes

Description / Purpose

Small bitmap logo

text string

ex: "0=begin 666

Line 1 of the uuencoding of the

abc_sm.bmp"

small bitmap used for branding

Internet Explorer.

text string

ex: "1= à"

Line 2 of the uuencoding.

text string

ex: "47=end"

Last line of the uuencoding.

[URL]

Entry

Value

Notes

Description / Purpose

AutoConfig

1 = Yes / 0 = No

Specifies whether Auto-Config is

to be supported.

AutoConfigJSURL

URL

ex:

URL of a JavaScript file that

http://www.server.com/au

automatically sets the proxy server.

toprx.js

AutoConfigURL

URL

ex:

URL of an .INS file to be used for

http://www.server.com/au

Auto-Config.

tocon.ins

Help_Page

ex: http://abc.help.htm

Set URL for the HTML Help.

Home_Page

URL

ex: http://www.msn.com

The WWW client's home page

URL.

NoWelcome

1 = Yes / 0 = No

TBD

Display IE4 welcome page??

Quick_Link_1

URL

ex:

Set URL for Quick Link 1.

http://home.microsoft.co

m/best/best.asp

Quick_Link_1_Name

text string

ex: Best of the Web

Set name for Quick Link 1.

Quick_Link_2

URL

ex:

Set URL for Quick Link 2.

http://home.microsoft.co

m/links/links.asp

Quick_Link_2_Name

text string

ex: Today's Links

Set name for Quick Link 2.

Quick_Link_3

URL

ex:

Set URL for Quick Link 3.

http://home.microsoft.co

m/gallery.asp

Quick_Link_3_Name

text string

ex: Web Gallery

Set name for Quick Link 3.

Quick_Link_4

URL

ex:

Set URL for Quick Link 4.

http://home.microsoft.co

m/ie

Quick_Link_4_Name

text string

ex: Product News

Set name for Quick Link 4.

Quick_Link_5

URL

ex:

Set URL for Quick Link 5.

http://home.microsoft.co

Quick_Link_5_Name

text string

ex: Microsoft

Set name for Quick Link 5.

Search_Page

ex:

The WWW client's search page

http://ww.msn.com/acces

URL.

s/allinone.htm

[User]

Entry

Value

Notes

Description / Purpose

Display_Password

Yes / No

Default = No

Should the username and

password be displayed to the user

at the completion of sign-up?

Name

text string

The user name used to log in.

Password

text string

The password used to log in.

[Warnings]

Entry

Value

Notes

Description / Purpose

Warnings parameters section.

Trust Level

number

[WebviewFolders]

Entry

Value

Notes

Description / Purpose

Webview folder paramters

Path0

Path

ex: C:\