Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Firefox-Embedded Selector 1.0"

(Deployer Perspective)
(Building)
 
(46 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Introduction ==
 
An identity selector is an end-user application that allows a user to accept [http://en.wikipedia.org/wiki/I-card i-cards] from card issuing sites (known as Identity Providers or IdPs), create self-issued i-cards, manage the user's set of cards (a bit like a wallet), and to use these cards to authenticate to relying sites, or to local applications. These i-cards are visualized as card icons in a user interface that allows the user to review, manage and in some cases edit some of the information associated with the card.
 
  
The long term plan is that these selectors will support all of the major identity protocols and run on all popular platforms. In the past year we have worked mostly on interoperability with Microsoft CardSpace-compatible card issuing and relying sites, systems and services as well as with OpenID OPs and relying sites.
+
[[Image:Higgins_logo_76Wx100H.jpg|right]]
 +
 
 +
[[Firefox-Embedded Selector 1.0]] is a card selector implemented as a FireFox add-on that relies on a hosted [[I-Card Service]] web service that persists and manages (creates, edits, updates, deletes, etc ) the user's i-cards. A brief [http://www.parity.com/library.html Flash demo] is available.
  
 
== End-User Perspective ==
 
== End-User Perspective ==
  
 
=== Setup ===
 
=== Setup ===
To use this solution you must:
+
Follow the instructions here: [[Firefox-Embedded Selector 1.0 Installation]] to install the this extension into Firefox. After re-starting your browser the setup wizard will help you set up your account on the free Eclipse test server.
# '''Follow the instructions here: [[Embedded-Selector For Firefox Installation]]''' to install the this Higgins extension into Firefox.  
+
# After re-starting your browser the setup wizard will help you set up your account on https://graceland.parityinc.net, the free test server run by Parity.
+
  
 
=== Functionality ===
 
=== Functionality ===
You should now be able to:
+
 
* Import Microsoft CardSpace-compatible managed cards from test sites listed under "Identity Providers" here: [[CardSpace Interop]]. You go to the card issuing site, create a .crd file for the card. If you click on the link to the .crd file, the browser extension will pop up and automatically import this into the selector. If you have a .crd file on your hard drive, there is an import button in the i-card manager to manually import it into the selector.
+
'''Getting a Card.'''
* If you click on the "mouse" button on the Higgins toolbar in Firefox the "i-card manager" web app will appear in your browser. You should be able to see your card(s) here.  
+
 
* You can select a card and delete it if you wish.
+
See [http://informationcard.net/card-projects Sites Issuing Cards] for a list. Most sites work roughly like this:
* If you go to the test sites listed under "Relying Party Sites" here: [[CardSpace Interop]] you should be able to sign in using the card (assuming that the claims supported by the card you used satisfy the relying site's policy).
+
* You go to the issuing site, and create a card.  
 +
* If the site provides a link to your new card (.crd file), then the browser extension will pop up and automatically import it into the selector.  
 +
* If, on the other hand, you have a .crd file on your hard drive, there is an import button in the i-card manager interface (see next step below) to manually import it into the selector.
 +
* If you click on the "mouse" button that has been added next to your "home" icon at the top of the Firefox window, the "i-card manager" web app will appear in a new tab within your browser. You should be able to see your card(s) here. You can select a card and delete it if you wish.
 +
 
 +
'''Logging in with a card'''
 +
 
 +
See [http://informationcard.net/resources/sites-accepting-cards Sites Accepting Cards]
 +
 
 +
=== Known bugs ===
 +
* There is a FireFox bug [https://bugzilla.mozilla.org/show_bug.cgi?id=401611 #401611] superceded by [https://bugzilla.mozilla.org/show_bug.cgi?id=409888 #409888] that prevents the selector from appearing on certain RPs in FF 2.0.0.8 and later. Still broken as of 2.0.0.12. To address this a workaround fix has been implemented [https://bugs.eclipse.org/bugs/show_bug.cgi?id=222142 with 222142] and is available in the latest HBX release.
  
 
== Deployer Perspective ==
 
== Deployer Perspective ==
  
 
This overall solution is comprised of these three sub-systems which must be built and deployed:
 
This overall solution is comprised of these three sub-systems which must be built and deployed:
# [[Deploying the Higgins Browser Extension for Firefox]]
+
# [[Deploying the Embedded-Selector Extension for Firefox]]
 
#* Constituent components include: [[Higgins Embedded-Selector Extension for Firefox]]  
 
#* Constituent components include: [[Higgins Embedded-Selector Extension for Firefox]]  
 
# [[Deploying the Higgins I-Card Manager Service]]
 
# [[Deploying the Higgins I-Card Manager Service]]
 
#* Constituent components include: [[I-Card Manager]]  
 
#* Constituent components include: [[I-Card Manager]]  
# [[Deploying the I-Card Service]]
+
# [[Deploying I-Card Service 1.0]]
#* Constituent components include: [[Identity Agent Service]], [[I-Card Selector Service]], [[I-Card Registry]], [[I-Card Provider]], [[Token Service]], [[Identity Attribute Service]], Jena [[Context Provider]]
+
#* Constituent components include: [[I-Card Service Web App]], [[I-Card Selector Service]], [[I-Card Registry]], [[I-Card Provider]], [[Token Service]], [[Identity Attribute Service]], Jena [[Context Provider]]
  
 
== Developer Perspective ==
 
== Developer Perspective ==
Line 33: Line 41:
 
For Higgins 1.0 the Web-based identity selector only supports integration with Firefox on Windows and Mac OSX. Support for other browsers and platforms is under active development.
 
For Higgins 1.0 the Web-based identity selector only supports integration with Firefox on Windows and Mac OSX. Support for other browsers and platforms is under active development.
  
The Firefox implementation uses an embedded i-card selector within the [[Higgins Browser Extension]]. This has been available since 1.0M4.  
+
The Firefox implementation uses an embedded i-card selector within the [[Higgins Embedded-Selector Extension for Firefox]]. This has been available since 1.0M4.  
[[Image:Firefox-Embedded-Selector-v60.PNG]]
+
 
 +
[[Image:HigginsFFEmbeddedSel1_B100_v2.1.PNG]]
  
 
=== Building ===
 
=== Building ===
Line 44: Line 53:
 
# [[Building the Higgins I-Card Manager Service]]
 
# [[Building the Higgins I-Card Manager Service]]
 
#* Constituent components include: [[I-Card Manager]]  
 
#* Constituent components include: [[I-Card Manager]]  
# [[Building the Higgins I-Card Service]]
+
# [[Building I-Card Service 1.0]]
#* Constituent components include: [[I-Card Service]], [[I-Card Selector Service]], [[I-Card Registry]], [[I-Card Provider]], [[Token Service]], [[Identity Attribute Service]], Jena [[Context Provider]]
+
#* Constituent components include: [[I-Card Service Web App]], [[I-Card Selector Service]], [[I-Card Registry]], [[I-Card Provider]], [[Token Service]], [[Identity Attribute Service]], Jena [[Context Provider]]
 
+
== See Also ==
+
* [[Solutions]]
+
 
+
== Links ==
+
* [http://eclipse.org/higgins Higgins Home]
+

Latest revision as of 15:13, 15 August 2014

Higgins logo 76Wx100H.jpg

Firefox-Embedded Selector 1.0 is a card selector implemented as a FireFox add-on that relies on a hosted I-Card Service web service that persists and manages (creates, edits, updates, deletes, etc ) the user's i-cards. A brief Flash demo is available.

End-User Perspective

Setup

Follow the instructions here: Firefox-Embedded Selector 1.0 Installation to install the this extension into Firefox. After re-starting your browser the setup wizard will help you set up your account on the free Eclipse test server.

Functionality

Getting a Card.

See Sites Issuing Cards for a list. Most sites work roughly like this:

  • You go to the issuing site, and create a card.
  • If the site provides a link to your new card (.crd file), then the browser extension will pop up and automatically import it into the selector.
  • If, on the other hand, you have a .crd file on your hard drive, there is an import button in the i-card manager interface (see next step below) to manually import it into the selector.
  • If you click on the "mouse" button that has been added next to your "home" icon at the top of the Firefox window, the "i-card manager" web app will appear in a new tab within your browser. You should be able to see your card(s) here. You can select a card and delete it if you wish.

Logging in with a card

See Sites Accepting Cards

Known bugs

  • There is a FireFox bug #401611 superceded by #409888 that prevents the selector from appearing on certain RPs in FF 2.0.0.8 and later. Still broken as of 2.0.0.12. To address this a workaround fix has been implemented with 222142 and is available in the latest HBX release.

Deployer Perspective

This overall solution is comprised of these three sub-systems which must be built and deployed:

  1. Deploying the Embedded-Selector Extension for Firefox
  2. Deploying the Higgins I-Card Manager Service
  3. Deploying I-Card Service 1.0

Developer Perspective

Architecture

For Higgins 1.0 the Web-based identity selector only supports integration with Firefox on Windows and Mac OSX. Support for other browsers and platforms is under active development.

The Firefox implementation uses an embedded i-card selector within the Higgins Embedded-Selector Extension for Firefox. This has been available since 1.0M4.

HigginsFFEmbeddedSel1 B100 v2.1.PNG

Building

This section describes the steps a developer would use to build deployable artifacts. The next section describes how to deploy them to create a runnable system.

This overall solution is comprised of the following sub-systems which must be built separately.

  1. Building the Higgins Browser Extension for Firefox
  2. Building the Higgins I-Card Manager Service
  3. Building I-Card Service 1.0

Back to the top