File: nsIClientAuthDialogService.idl

package info (click to toggle)
firefox 147.0.3-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 4,683,320 kB
  • sloc: cpp: 7,607,359; javascript: 6,533,295; ansic: 3,775,223; python: 1,415,500; xml: 634,561; asm: 438,949; java: 186,241; sh: 62,752; makefile: 18,079; objc: 13,092; perl: 12,808; yacc: 4,583; cs: 3,846; pascal: 3,448; lex: 1,720; ruby: 1,003; php: 436; lisp: 258; awk: 247; sql: 66; sed: 54; csh: 10; exp: 6
file content (51 lines) | stat: -rw-r--r-- 2,160 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"
#include "nsIClientAuthRememberService.idl"

interface nsILoadContext;
interface nsIX509Cert;

[scriptable, function, uuid(6b00d96d-fb8a-4c9f-9632-c9e1235befce)]
interface nsIClientAuthDialogCallback : nsISupports
{
  void certificateChosen(in nsIX509Cert cert, in nsIClientAuthRememberService_Duration rememberDuration);
};

/**
 * Provides UI when a server requests a TLS client authentication certificate.
 */
[scriptable, uuid(fa4c7520-1433-11d5-ba24-00108303b117)]
interface nsIClientAuthDialogService : nsISupports
{
  /**
   * Called when a user is asked to choose a certificate for client auth.
   *
   * @param hostname Hostname of the server.
   * @param certArray Array of certificates the user can choose from.
   *                  Expected to be empty on Android.
   * @param loadContext The nsILoadContext of the connection requesting a
   *                    certificate. May be null, in which case the
   *                    implementation will use the most recent window to show
   *                    UI.
   * @param caNames Array of arrays of bytes representing X.500 Distinguished
   *                Names that the server specified as acceptable issuers for
   *                the client certificate. On non-Android platforms, certArray
   *                will have already been filtered by this list, and it can be
   *                ignored.
   * @param callback The nsIClientAuthDialogCallback to call when a certificate
   *                 has been chosen (or no certificate).
   */
  [must_use]
  void chooseCertificate(in AUTF8String hostname,
                         in Array<nsIX509Cert> certArray,
                         in nsILoadContext loadContext,
                         in Array<Array<octet> > caNames,
                         in nsIClientAuthDialogCallback callback);
};

%{C++
#define NS_CLIENTAUTHDIALOGSERVICE_CONTRACTID "@mozilla.org/security/ClientAuthDialogService;1"
%}