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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
/*******************************************************************************
* Copyright (c) 2008, 2009 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.equinox.internal.provisional.p2.core;
import java.security.cert.Certificate;
/**
* Service used for prompting for user information from within lower level code.
* Implementors of this service are responsible for registering the service.
*
* It is possible that the IServiceUI service is requested very early in the startup
* sequence for an application. For example, applications that check for updates
* during startup will trigger the service lookup if a server requiring authentication
* is detected. For this reason, implementors of IServiceUI should ensure that the
* bundle providing the service is partitioned appropriately.
*/
public interface IServiceUI {
/**
* Service name constant for the UI service.
*/
public static final String SERVICE_NAME = IServiceUI.class.getName();
/**
* Authentication information returned from an authentication prompt request.
*/
public static class AuthenticationInfo {
private final boolean save;
private final String userName;
private final String password;
public AuthenticationInfo(String userName, String password, boolean saveResult) {
this.userName = userName;
this.password = password;
this.save = saveResult;
}
public boolean saveResult() {
return save;
}
public String getUserName() {
return userName;
}
public String getPassword() {
return password;
}
}
/**
* Trust information returned from a trust request. *
*/
public static class TrustInfo {
private final Certificate[] trustedCertificates;
private final boolean saveTrustedCertificates;
private final boolean trustUnsigned;
public TrustInfo(Certificate[] trusted, boolean save, boolean trustUnsigned) {
this.trustedCertificates = trusted;
this.saveTrustedCertificates = save;
this.trustUnsigned = trustUnsigned;
}
/**
* Return an array of the certificates that should be trusted for the
* requested operation.
*
* @return the trusted certificates, or <code>null</code> if there are
* no certificates that were verified as trusted.
*/
public Certificate[] getTrustedCertificates() {
return trustedCertificates;
}
/**
* Return a boolean indicating whether the trusted certificates should
* be persisted for future operations.
*
* @return <code>true</code> if the trusted certificates should be persisted, <code>false</code> if
* the trust only applies for this request.
*/
public boolean persistTrust() {
return saveTrustedCertificates;
}
/**
* Return a boolean indicating whether the unsigned content should be trusted
* during this operation.
*
* @return <code>true</code> if the unsigned content should be trusted, or if there was no unsigned content,
* and <code>false</code> if there was unsigned content and should not be trusted.
*/
public boolean trustUnsignedContent() {
return trustUnsigned;
}
}
/**
* Opens a UI prompt for authentication details
*
* @param location - the location requiring login details, may be <code>null</code>.
* @return The authentication result
*/
public AuthenticationInfo getUsernamePassword(String location);
/**
* Opens a UI prompt for authentication details when cached or remembered details
* where not accepted.
*
* @param location the location requiring login details
* @param previousInfo - the previously used authentication details - may not be null.
* @return The authentication result
*/
public AuthenticationInfo getUsernamePassword(String location, AuthenticationInfo previousInfo);
/**
* Opens a UI prompt to capture information about trusted content.
*
* @param untrustedChain - an array of certificate chains for which there is no current trust anchor. May be
* <code>null</code>, which means there are no untrusted certificate chains.
* @param unsignedDetail - an array of strings, where each String describes content that is not signed.
* May be <code>null</code>, which means there is no unsigned content
* @return the TrustInfo that describes the user's choices for trusting certificates and
* unsigned content.
*/
public TrustInfo getTrustInfo(Certificate[][] untrustedChain, String[] unsignedDetail);
}
|
