Help

Subscriber Services allows subscription administrators to view and update aspects of their subscriptions.

You must log in using your account's administrator username and password to use these features:

This page displays key details about your Account and your Account Contact details.

Contact Details can be changed on this page apart from key details that cannot be changed online. If you wish to change these details please Contact Us.

This page lists all Subscriptions that relate to your account. These may be trial or live Subscriptions.

Product: The links in the Product column take you to the live site for that Product. If your Subscription does not have a Status of OK you will not be able to access the site, and will be taken to the publicly accessible pages for the site. If your Subscription is OK you may need to log in using your user name and password, if your account is not set up to authenticate using IP or referrer credentials.

Status: For each subscription, one of the following will be visible in the Status column:

OK
an active subscription that will allow access to the products
Suspended
the subscription has been suspended because automated abuse-detection has been triggered
Expired
the subscription has been automatically expired because it has reached its end date
Cancelled
the subscription has been cancelled by hand
Provisional
a subscription that has been created and is waiting for your acceptance of the terms and conditions
Unchecked
a subscription that is awaiting administrative staff's approval

Type: details whether your subscription is a trial or a full subscription.

Concurrency: details how many users can use this subscription concurrently.

Start/End date: The start and end dates of the subscription during which access will be allowed.

A Subscription can have a number of Accounts associated with it as "Named Users" of that Subscription.

Named Users of your subscriptions can be administered via the Named User tab in the Subscription view.

Subscriptions that you are a Named User of are listed in the "Associated Subscriptions" tab.

If you are marked as Named User Administrator, you have access to View/Add/Remove Named Users from that Subscription via Subscriber Services (subject to the usual Subscriber Services authentication checks). Administration of Named Users via Subscriber Services is limited to:

IP Address Ranges

SAMS stores ranges of IP addresses for an Account in CIDR format which enables authorised access to a product site to be determined by the users IP address. This is typically used by institutions who have a subscription with concurrent access and want to allow access from all on-site computers (e.g. a university allowing their library computers to gain access).

All CIDR ranges keyed are converted to CIDR format when the data is submitted. On entry of new IP address ranges, the WHOIS search results for that data must always be reviewed by the user before the data entry is completed. This is accomplished by a click through the WHOIS search results screen.

The system prevents the entry of ranges bigger than /8, and prevents the entry of private non Internet IP addresses. If an IP address range is added which conflicts with an existing account the system returns an informational page indicating the conflicting account and range, with links to edit either account and a display of the WHOIS search for this range.

The following IP addresses are reserved for Private use (internal networks):

  • 10.0.0.0 - 10.255.255.255 (10.0.0.0/8)
  • 172.16.0.0 - 172.16.255.255 (172.16.0.0/16)
  • 192.168.0.0 - 192.168.255.255 (192.168.0.0/16)

Allowed/Blocked

An IP address that falls within an Allowed range will be granted access to the product site provided that both the Subscription and the Product are also set up to allow IP authentication. However, if an IP address falls within the Blocked range for that Account, it will not be granted access.

Username and Password

An Account can have any number of Username/Passwords stored against it. A Username must be unique across SAMS.

There are four levels of users for SAMS:

administrator
has the right to make data changes across SAMS Admin and Subscriber Services.
ip-editor
has no access to SAMS Admin but has the right to manage IP addresses via Subscriber Services
ss-limited
has no access to SAMS Admin and has read-only access to Subscriber Services
public
has access to the Product Site only

HTTP Referrer

SAMS can determine authorisation by using the referrer property of a user's HTTP request to a Product Site. Mostly used by institutions providing an intranet page that links to the Product Site. If the user is behind a proxy, SAMS can also use the x_forwarded_for property which most good proxy servers will set to allow the correct referrer to be retained and identified.

Shibboleth Credentials

Shibboleth credentials may be provided for a given Account if desired. If they are provided then both fields will be mandatory. The fields are as follows:

Organisation ID

This is the Attribute that is released by the IdP to identify the institution. This is not contained within federation metadata and must be requested from the IdP. SAMS checks the following attributes:

  • eduPersonPrimaryOrgUnitDN
  • urn:mace:dir:attribute-def:eduPersonPrimaryOrgUnitDN
  • urn:mace:dir:attribute-def:eduPersonScopedAffiliation

Entity ID

This is the unique identifier for the IdP and should be declared in the metadata associated with the IdP. In the UK Federation Metadata this is found in the entityID attribute of the EntityDescriptor node for an IdP.

Library Card

Institutions wishing to provide access for users via their Library Card IDs can do so by setting up a Library Card Mask and optionally a Library Code.

Library Card Mask

This is a pattern that allows multiple Library Card IDs to be matched against a single Subscription.

  • \d - matches a single digit
  • \w - matches a single upper or lower case letter or underscore
  • \c - matches any permitted symbol
For example, the pattern 1234\d\d\d-567\c\w\w\w would match any of the following Library Card IDs:
  • 1234678-567@abc
  • 1234345-567?xyz
  • 1234876-567*def

Library Code

Since different Libraries may share a Library Card ID format, a Library Code can also be defined to identify a specific Library. Both Subscription and Product must be set up to enforce Library Code. If a Library Code is then also supplied with the Library Card Mask at Authentication, then both must match the values stored against the Account. Note that Library Code is an exact match, not a pattern.

International Coalition of Library Consortia (ICOLC)

There are three reports available:

ICOLC usage reports are available on a monthly basis to subscribing institutions and library consortia and show the following information:

COUNTER Reports

A brief summary of the available COUNTER reports:

See the COUNTER 4 Glossaries for more details.

List of Country ids and names as used by SAMS.

ID - Country name

af
Afghanistan
al
Albania
dz
Algeria
as
American Samoa
ad
Andorra
ao
Angola
ai
Anguilla
aq
Antarctica
ag
Antigua and Barbuda
ar
Argentina
am
Armenia
aw
Aruba
au
Australia
at
Austria
az
Azerbaijan
bs
Bahamas
bh
Bahrain
bd
Bangladesh
bb
Barbados
by
Belarus
be
Belgium
bz
Belize
bj
Benin
bm
Bermuda
bt
Bhutan
bo
Bolivia
ba
Bosnia and Herzegovina
bw
Botswana
bv
Bouvet Island
br
Brazil
io
British Indian Ocean Territory
bn
Brunei Darussalam
bg
Bulgaria
bf
Burkina Faso
bi
Burundi
kh
Cambodia
cm
Cameroon
ca
Canada
cv
Cape Verde
ky
Cayman Islands
cf
Central African Republic
td
Chad
cl
Chile
cn
China
cx
Christmas Island
cc
Cocos (Keeling) Islands
co
Colombia
km
Comoros
cg
Congo
cd
Congo, The Democratic Republic of the
ck
Cook Islands
cr
Costa Rica
ci
Cote D'Ivoire
hr
Croatia
cu
Cuba
cy
Cyprus
cz
Czech Republic
dk
Denmark
dj
Djibouti
dm
Dominica
do
Dominican Republic
ec
Ecuador
eg
Egypt
sv
El Salvador
gq
Equatorial Guinea
er
Eritrea
ee
Estonia
et
Ethiopia
fk
Falkland Islands (Malvinas)
fo
Faroe Islands
fj
Fiji
fi
Finland
fr
France
gf
French Guiana
pf
French Polynesia
tf
French Southern Territories
ga
Gabon
gm
Gambia
ge
Georgia
de
Germany
gh
Ghana
gi
Gibraltar
gr
Greece
gl
Greenland
gd
Grenada
gp
Guadeloupe
gu
Guam
gt
Guatemala
gn
Guinea
gw
Guinea-Bissau
gy
Guyana
ht
Haiti
hm
Heard Island and McDonald Islands
va
Holy See (Vatican City State)
hn
Honduras
hk
Hong Kong
hu
Hungary
is
Iceland
in
India
id
Indonesia
ir
Iran, Islamic Republic of
iq
Iraq
ie
Ireland
il
Israel
it
Italy
jm
Jamaica
jp
Japan
jo
Jordan
kz
Kazakhstan
ke
Kenya
ki
Kiribati
kp
Korea, Democratic People's Republic of
kr
Korea, Republic of
kw
Kuwait
kg
Kyrgyzstan
la
Lao People's Democratic Republic
lv
Latvia
lb
Lebanon
ls
Lesotho
lr
Liberia
ly
Libyan Arab Jamahiriya
li
Liechtenstein
lt
Lithuania
lu
Luxembourg
mo
Macao
mk
Macedonia, the Former Yugoslav Republic of
mg
Madagascar
mw
Malawi
my
Malaysia
mv
Maldives
ml
Mali
mt
Malta
mh
Marshall Islands
mq
Martinique
mr
Mauritania
mu
Mauritius
yt
Mayotte
mx
Mexico
fm
Micronesia, Federated States of
md
Moldova, Republic of
mc
Monaco
mn
Mongolia
ms
Montserrat
ma
Morocco
mz
Mozambique
mm
Myanmar
na
Namibia
nr
Nauru
np
Nepal
nl
Netherlands
an
Netherlands Antilles
nc
New Caledonia
nz
New Zealand
ni
Nicaragua
ne
Niger
ng
Nigeria
nu
Niue
nf
Norfolk Island
mp
Northern Mariana Islands
no
Norway
om
Oman
pk
Pakistan
pw
Palau
ps
Palestinian Territory, Occupied
pa
Panama
pg
Papua New Guinea
py
Paraguay
pe
Peru
ph
Philippines
pn
Pitcairn
pl
Poland
pt
Portugal
pr
Puerto Rico
qa
Qatar
XK
Republic of Kosovo
re
Reunion
ro
Romania
ru
Russian Federation
rw
Rwanda
sh
Saint Helena
kn
Saint Kitts and Nevis
lc
Saint Lucia
pm
Saint Pierre and Miquelon
vc
Saint Vincent and the Grenadines
ws
Samoa
sm
San Marino
st
Sao Tome and Principe
sa
Saudi Arabia
sn
Senegal
cs
Serbia and Montenegro
sc
Seychelles
sl
Sierra Leone
sg
Singapore
sk
Slovakia
si
Slovenia
sb
Solomon Islands
so
Somalia
za
South Africa
gs
South Georgia and the South Sandwich Islands
es
Spain
lk
Sri Lanka
sd
Sudan
sr
Suriname
sj
Svalbard and Jan Mayen
sz
Swaziland
se
Sweden
ch
Switzerland
sy
Syrian Arab Republic
tw
Taiwan
tj
Tajikistan
tz
Tanzania, United Republic of
th
Thailand
tl
Timor-Leste
tg
Togo
tk
Tokelau
to
Tonga
tt
Trinidad and Tobago
tn
Tunisia
tr
Turkey
tm
Turkmenistan
tc
Turks and Caicos Islands
tv
Tuvalu
us
USA
ug
Uganda
ua
Ukraine
ae
United Arab Emirates
gb
United Kingdom
um
United States Minor Outlying Islands
xx
Unknown
uy
Uruguay
uz
Uzbekistan
vu
Vanuatu
ve
Venezuela
vn
Viet Nam
vg
Virgin Islands, British
vi
Virgin Islands, U.S.
wf
Wallis and Futuna
eh
Western Sahara
ye
Yemen
zm
Zambia
zw
Zimbabwe
Loading...