Information

Finansiell ID-Teknik BID AB
Information Mobilt BankID för WP8 och WindowsRT
Version 1.0
Sida 1(3)
Datum:2013-02-20
Mobilt BankID för Windows Phone 8 och Windows RT (surfplattor med ARM-processor) kommer
att lanseras sommaren 2013. Informationen nedan kompletterar befintliga riktlinjer och kan
användas av Förlitande Part för att i förväg anpassa sina Windows Phone 8-appar och RT-appar
(ARM).
7.3 Programmatisk start av BankID säkerhetsapp
7.3.3 Windows RT (ARM)
Om inte Mobilt BankID finns installerat när URL anropas kommer användaren att få en fråga att
ansluta till Windows Store för att hämta ner den.
// Create the URI string
var uriToLaunch = @"bankid://www.bankid.com/redirect=" +
Uri.EscapeDataString("fp-app-x://bank_x");
// Create the URI to launch from a string.
var uri = new Uri(uriToLaunch);
// Launch the URI.
bool success = await Windows.System.Launcher.LaunchUriAsync(uri);
7.3.4 Windows Phone 8
Om inte Mobilt BankID finns installerat när URL anropas kommer användaren att få en fråga att
ansluta till Windows Store för att hämta ner den.
// Create the URI string
var uriToLaunch = @"bankid://www.bankid.com/redirect=" +
Uri.EscapeDataString("fp-app-x://bank_x");
// Create the URI to launch from a string.
var uri = new Uri(uriToLaunch);
// Launch the URI.
bool success = await Windows.System.Launcher.LaunchUriAsync(uri);
7.6 Återstart av FP-app i Windows RT (ARM)
För att BankID säkerhetsapp ska kunna återstarta FP-app efter legitimering/underskrift måste FP:
1. registrera ett unikt URL-schema i FP-app, samt
2. hantera fallet då FP-app startas med URL-schema-förfarandet.
I exemplen används URL-schemat fp-app-x. FP ska ändra fp-app-x till det URL-schema FP vill använda.
7.6.1 Registrera schema
1.
I Visual Studio:
Öppna Package.appxmanifest
2.
Öppna fliken Declarations.
3.
Lägg till ett "Protocol". Under name skriver du fp-app-x.
4.
Ange en logo och ett "Display name".
Finansiell ID teknik BID AB
Information Mobilt BankID för WP8 och WindowsRT
Version 1.0
Sida 2(3)
Datum:2013-02-20
7.6.2 Hantera anrop / återstart
1.
2.
Återstarten av FP-appen sker i Application-klassen. I Visual Studio:
Öppna App.xaml.cs.
Lägg till metoden OnActivated enligt nedan, där MainView är den Page som ni vill ska aktiveras efter
återstarten:
/// <summary>
/// The on activated.
/// </summary>
/// <param name="args">
/// The args.
/// </param>
protected override void OnActivated(IActivatedEventArgs args)
{
base.OnActivated(args);
if (args.Kind == ActivationKind.Protocol)
{
var rootFrame = new Frame();
rootFrame.Navigate(typeof(MainView));
Window.Current.Content = rootFrame;
}
Window.Current.Activate();
}
7.7 Återstart av FP-app i Windows Phone 8
För att BankID säkerhetsapp ska kunna återstarta FP-app efter legitimering/underskrift måste FP:
1. registrera ett unikt URL-schema i FP-app, samt
2. hantera fallet då FP-app startas med URL-schema-förfarandet.
I exemplen används URL-schemat fp-app-x. FP ska ändra fp-app-x till det URL-schema FP vill använda.
1.
7.7.1 Registrera schema
Öppna WMAppManifest.xml med en text-editor
2.
Lägg till ett "Tokens" lägger du till följande:
<Extensions>
<Protocol Name="fp-app-x" NavUriFragment="encodedLaunchUri=%s"
TaskID="_default" />
</Extensions>
7.7.2 Hantera anrop / återstart
1.
I VisualStudio:
Lägg till klassen AssociationUriMapper enligt följande:
/// <summary>
/// The association uri mapper.
/// </summary>
internal class AssociationUriMapper : UriMapperBase
{
/// <summary>
/// When overridden in a derived class, converts a requested uniform
resource identifier (URI) to a new URI.
/// </summary>
Finansiell ID teknik BID AB
Information Mobilt BankID för WP8 och WindowsRT
Version 1.0
Sida 3(3)
Datum:2013-02-20
/// <returns>
/// A URI to use for the request instead of the value in the <paramref
name="uri"/> parameter.
/// </returns>
/// <param name="uri">The original URI value to be mapped to a new
URI.</param>
public override Uri MapUri(Uri uri)
{
var tempUri = System.Net.HttpUtility.UrlDecode(uri.ToString());
// URI association launch.
if (tempUri.StartsWith("/Protocol"))
{
// Here we can redirect to the correct page, but for now we
don't
return new Uri("/MainPage.xaml", UriKind.Relative);
}
// Otherwise perform normal launch.
return uri;
}
}
1.
I App.xaml.cs, lägg till AssociationUriMapper som UriMapper genom att i metoden
InitializePhoneApplication lägga till följande rad:
// Assign the URI-mapper class to the application frame.
RootFrame.UriMapper = new AssociationUriMapper();