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 "AIR Client+Server"

(I-Card Registry (component set))
(Removing all content from page)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}
 
==Version 1.1 ==
 
* This page describes the Adobe AIR based selector solution being developed for Higgins 1.1 (see [[Solutions 1.1]])
 
* This solution is not part of Higgins 1.0.
 
  
==Introduction==
 
This solution provides an [http://www.adobe.com/products/air/ Adobe AIR] based Identity Selector that runs on the local machine. It requires hosted I-Card component for I-Card management and [[Higgins Selector Selector]] components to interact with the browser.
 
 
'''How it works'''
 
# When user submits an info-card form in the browser, the browser extension intercepts the action, collect the policy string, and sends the string to [[Higgins Selector Selector]]. [[Higgins Selector Selector]] invokes the [[Adobe AIR-based Identity Selector]] using the [[Connector for Adobe AIR Selector]].
 
# [[Adobe AIR-based Identity Selector]] communicates to hosted I-Card service and shows I-Card Selector UI
 
# User selects an I-Card and clicks "Send this card" button
 
# [[Adobe AIR-based Identity Selector]] gets security token for the selected I-Card from hosted I-Card service and sends token to [[Higgins Selector Selector]]
 
# Browser extension retrieves token from [[Higgins Selector Selector]]
 
# Browser extension submits token to RP
 
 
==End-User Perspective==
 
There is a brief demo of this solution being used with a desktop application as the relying party. See the [http://www.parity.com/demo/map/index.htm  Map Demo]. (Adobe Flash Player 9 required)
 
 
===Functionality===
 
Adobe AIR Selector solution uses hosted [[I-Card Service]], [[I-Card Manager]] and [[Higgins Selector Selector]]. A demo version of hosted [[I-Card Service]] and [[I-Card Manager]] are installed at https://higgins.eclipse.org
 
 
This application requires Adobe AIR Runtime 1.0 or greater. During installation process, the installer will look for existence of Adobe AIR Runtime on the system. If the runtime is not present, installer will download and install the runtime from [http://get.adobe.com/air adobe.com].
 
 
AIR selector has the following capabilities:
 
 
# Allows user to setup an account in hosted [[I-Card Service]]
 
# Allows user to edit the hosted [[I-Card Service]] configuration and other preferences
 
# Retrieves cards from remote storage based on RP Policy
 
# Retrieves token via RPPS for the selected card
 
# Sends token to RP using [[Higgins Selector Selector]]
 
# Imports .crd file to user's account
 
# Opens [[I-Card Manager]] in user's default browser
 
 
When user completes the installation of [[Higgins Selector Selector]], installer invokes the AIR Selector and opens account provisioning wizard. User can either create a new [[I-Card Service]] account or setup the existing account to use in AIR Selector.
 
 
[[Image:Air_wizard.png|thumb|none|Account provisioning wizard]]
 
 
AIR Selector is invoked from web browser using [[Higgins Selector Selector]] with the RP Policy. AIR Selector contacts RPPS using web service call and retrieves all cards matching RP Policy.
 
 
[[Image:Air cards.png|thumb|none|Card Selector]]
 
 
User can preview the claim values by clicking on a card.
 
 
[[Image:Air_cards_values.png|thumb|none|Card Selector with claim values]]
 
 
User requests the token for the selected card via RPPS and sends the token to RP through [[Higgins Selector Selector]]
 
 
===Setup===
 
There are two possible installation options are available. One by installing the full stack of [[Higgins Selector Selector]] and another one is by installing just the AIR Selector and a browser plugin. The second option is currently available only for Firefox browser. A commercially-packaged version is also available at [http://www.azigo.com/getazigo.html Azigo.com].
 
 
1. '''[[Higgins Selector Selector]] installation'''
 
 
#Run installer.exe from app/org.eclipse.higgins.tcpserver/src/SSSupport/bin/setup/ when the build for [[Higgins Selector Selector]] is completed.
 
#Follow the instructions of the installer and completes the installation. Browser plugins, Selector Switcher, Selector Selector core and Connectors for different selectors will be installed by the installer.
 
 
2. '''AIR Selector and Firefox extension'''
 
 
''Note'': This light weight installation provides a direct connection from Firefox browser to AIR Selector. This bypasses the full stack of [[Higgins Selector Selector]] components. This option is recommended only for testing purpose or only for the platforms that don't have [[Higgins Selector Selector]] yet (e.g. Mac/Linux)
 
 
#Download and install Adobe AIR Runtime from http://get.adobe.com/air/
 
#Download and install AIR Selector from https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/app/org.eclipse.higgins.air/bin/CardSelector.air
 
#Install [[Higgins Browser Extension for Firefox]] by following [[Higgins Browser Extension for Firefox Installation]] steps
 
 
==Deployer Perspective==
 
 
===Deploying===
 
This is a desktop application and it is installed by running the insller.exe binary from app/org.eclipse.higgins.tcpserver/src/SSSupport/bin/setup/ when the build is completed.
 
 
#Build [[Higgins Selector Selector]] components
 
#Go to app/org.eclipse.higgins.tcpserver/src/SSSupport/bin/setup/ and run installer.exe file
 
#Since installer bundles AIR Selector, it requires "Adobe AIR runtime"
 
## if AIR runtime is not installed, installer will install it.
 
## If installation of "Adobe AIR runtime" is not functional, installation will be aborted
 
## If "Adobe AIR runtime" is installed properly, installation will continue.
 
# Install [[Higgins Selector Selector]] to a selected folder.
 
# Once the installation is completed it is ready for use.
 
 
==Developer Perspective==
 
===Architecture===
 
 
====AIR Identity Client====
 
 
[[Image:Air-identity-client.png]]
 
 
====Higgins Identity Server (component set) ====
 
 
[[Image:Higgins-identity-server.png]]
 
 
 
 
==== I-Card Selector Service (component set)====
 
 
[[Image:Iss-v1.1.119.png]]
 
 
==== I-Card Registry (component set) ====
 
 
[[Image:Icr-1.1.118.png]]
 
 
====Local STS (component set) ====
 
 
[[Image:Local-STS-1.1.100b.png]]
 
 
==== Utility (component set) ====
 
 
[[Image:Utility-1.1.png]]
 
 
===Building===
 
This section describes the steps a developer would use to build deployable artifacts. The overall solution is comprised of the following sub-systems:
 
# Selector-Selector component
 
# Selector installer component
 
# AIR selector connector component
 
# CardSpace selector connector component
 
 
This guide assumes you have the following software:
 
* Microsoft Visual Studio 2005 (see http://msdn2.microsoft.com/en-us/vstudio/default.aspx)
 
* boost bjam.exe (see http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?InstallingBoost)
 
 
1. Download selector selector source files (see: https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/app/org.eclipse.higgins.tcpserver/src)
 
 
2. Go to ./build directory and run build.bat file. This will build all parts of the [[Higgins Selector Selector]] Component
 
 
 
[[category:Higgins Solutions]]
 

Latest revision as of 22:37, 24 February 2009

Back to the top