blob: 6180e9289de976a0a6239cc655cc86e536789f3d (
plain)
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
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
* 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 "MailNewsTypes2.idl"
interface nsIAuthPrompt;
interface nsIUrlListener;
interface nsIURI;
interface nsIMsgWindow;
/**
* This interface represents a single SMTP Server. A SMTP server instance may be
* created/obtained from nsIMsgAccountManager.
*
* Most of the attributes will set/get preferences from the main preferences
* file.
*/
[scriptable, uuid(a53dce6c-cd81-495c-83bc-45a65df1f08e)]
interface nsISmtpServer : nsISupports {
/// A unique identifier for the server.
attribute string key;
/**
* A unique identifier for this server that can be used for the same
* server synced across multiple profiles. Auto-generated on first use.
*/
attribute AUTF8String UID;
/// A user supplied description for the server.
attribute AUTF8String description;
/// The server's hostname.
attribute AUTF8String hostname;
/// The server's port.
attribute int32_t port;
/// The username to access the server with (if required)
attribute ACString username;
/**
* The CLIENTID to use for this server (if required).
* @see https://tools.ietf.org/html/draft-storey-smtp-client-id-05
*/
attribute ACString clientid;
/**
* Whether the CLIENTID feature above is enabled.
*/
attribute boolean clientidEnabled;
/**
* The password to access the server with (if required).
*
* @note this is stored within the server instance but not within preferences.
* It can be specified/saved here to avoid prompting the user constantly for
* the sending password.
*/
attribute AString password;
/// Returns a displayname of the format hostname:port or just hostname
readonly attribute string displayname;
/**
* Authentication mechanism.
*
* @see nsMsgAuthMethod (in MailNewsTypes2.idl)
* Same as "mail.smtpserver...authMethod" pref
*
* Compatibility note: This attribute had a different meaning in TB < 3.1
*/
attribute nsMsgAuthMethodValue authMethod;
/**
* Whether to SSL or STARTTLS or not
*
* @see nsMsgSocketType (in MailNewsTypes2.idl)
* Same as "mail.smtpserver...try_ssl" pref
*/
attribute nsMsgSocketTypeValue socketType;
/**
* May contain an alternative argument to EHLO or HELO to provide to the
* server. Reflects the value of the mail.smtpserver.*.hello_argument pref.
* This is mainly useful where ISPs don't bother providing PTR records for
* their servers and therefore users get an error on sending. See bug 244030
* for more discussion.
*/
readonly attribute ACString helloArgument;
/// Returns the URI of the server (smtp:///)
readonly attribute AUTF8String serverURI;
/** Limit of concurrent connections to a server. */
attribute long maximumConnectionsNumber;
/** Close cached server connections. */
void closeCachedConnections();
/**
* Gets a password for this server, using a UI prompt if necessary.
*
* @param promptString The string to prompt the user with when asking for
* the password.
* @param promptTitle The title of the prompt.
* @return The password to use (may be null if no password was
* obtained).
*/
AString getPasswordWithUI(in wstring promptString, in wstring promptTitle);
/**
* Gets a username and password for this server, using a UI prompt if
* necessary.
*
* @param promptString The string to prompt the user with when asking for
* the password.
* @param promptTitle The title of the prompt.
* @param netPrompt An nsIAuthPrompt instance to use for the password
* prompt.
* @param userid The username to use (may be null if no password was
* obtained).
* @param password The password to use (may be empty if no password was
* obtained).
*/
void getUsernamePasswordWithUI(in wstring promptString, in wstring promptTitle,
in nsIAuthPrompt netPrompt, out ACString userid,
out AString password);
/**
* Calling this will *remove* the saved password for this server from the
* password manager and from the stored value.
*/
void forgetPassword();
/**
* Verify that we can logon
*
* @param aPassword - password to use
* @param aUrlListener - gets called back with success or failure.
* @return - the url that we run.
*
*/
nsIURI verifyLogon(in nsIUrlListener aUrlListener, in nsIMsgWindow aMsgWindow);
/// Call this to clear all preference values for this server.
void clearAllValues();
};
|
