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"

(IE Architecture Variant)
(Building)
 
(88 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Architecture ==
 
There are two variants of the H1 configuration. One for Firefox and one for IE. The IE variant uses a newer design. If the IE design works well, we will probably retrofit the Firefox [[Higgins Browser Extension]] to use the exact same architecture.
 
  
===Firefox Architecture Variant ===
+
[[Image:Higgins_logo_76Wx100H.jpg|right]]
The Firefox implementation uses an embedded i-card selector within the [[Higgins Browser Extension]]. This has been available since 1.0M4.
+
[[Image:Higgins-deploy-web-ia-v45.JPG]]
+
  
=== IE Architecture Variant ===
+
[[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.
The IE7 architecture relies on an external native code i-card selector that is invoked by the [[Higgins Browser Extension]]. This implementation is underdevelopment for 1.0 and has not yet been checked in. This variant is being developed for Windows initially, with Linux and OSX to follow later.  
+
 
+
[[Image:Higgins-deploy-web-ie-ia-v45.JPG]]
+
  
 
== End-User Perspective ==
 
== End-User Perspective ==
Warning: Higgins has not yet been released, there are still lots of bugs and missing features.
 
  
 
=== Setup ===
 
=== Setup ===
To use this configuration 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.
# Install the [[Higgins Browser Extension]] into your browser.  
+
# 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 hosted agent. 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 agent.
 
* 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.
 
* 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).
 
  
== Deployer and Developer Point of View ==
+
'''Getting a Card.'''
=== Constituent Components ===
+
 
Here is an overview of the Components used:
+
See [http://informationcard.net/card-projects Sites Issuing Cards] for a list. Most sites work roughly like this:
* [[Higgins Browser Extension for Firefox]] --Firefox variant only
+
* You go to the issuing site, and create a card.
* [[Higgins Browser Extension for IE7]] -- IE7 variant only
+
* 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.
* [[I-Card Selector]] -- IE7 variant only
+
* 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.
* [[I-Card Manager]]
+
* 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.
* [[RP Protocol Support]]
+
 
* [[I-Card Selector Service]]
+
'''Logging in with a card'''
* [[I-Card Registry]]
+
 
* [[I-Card Provider]]
+
See [http://informationcard.net/resources/sites-accepting-cards Sites Accepting Cards]
* [[Token Service]]
+
 
* [[Identity Attribute Service]]
+
=== Known bugs ===
* Jena [[Context Provider]]
+
* 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 ==
 +
 
 +
This overall solution is comprised of these three sub-systems which must be built and deployed:
 +
# [[Deploying the Embedded-Selector Extension for Firefox]]
 +
#* Constituent components include: [[Higgins Embedded-Selector Extension for Firefox]]  
 +
# [[Deploying the Higgins I-Card Manager Service]]
 +
#* Constituent components include: [[I-Card Manager]]  
 +
# [[Deploying I-Card Service 1.0]]
 +
#* 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 ==
 +
 
 +
=== 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.
  
=== Configure ===
+
[[Image:HigginsFFEmbeddedSel1_B100_v2.1.PNG]]
=== Build ===
+
  
== See Also ==
+
=== Building ===
* [[Deployments]]
+
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.
  
== Links ==
+
This overall solution is comprised of the following sub-systems which must be built separately.
* [http://eclipse.org/higgins Higgins Home]
+
# [[Building the Higgins Browser Extension for Firefox]]
 +
#* Constituent components include: [[Higgins Browser Extension for Firefox]]
 +
# [[Building the Higgins I-Card Manager Service]]
 +
#* Constituent components include: [[I-Card Manager]]
 +
# [[Building I-Card Service 1.0]]
 +
#* 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]]

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