Update it_IT/howto/1-enable.smtp.auth.on.port.25.md. Thanks Joseph Curto.

This commit is contained in:
Zhang Huangbin 2016-06-01 23:38:58 +08:00
parent d9ed11106c
commit f501da34af
11 changed files with 143 additions and 173 deletions

View File

@ -56,6 +56,10 @@ Notes:
<button type="button" class="toggle_all">Expand/Collapse All API Parameters</button>
### ChangeLog
* Variable name `cn` has been renamed to `name`.
### Domain {: .toggle }
<!--
@ -67,39 +71,39 @@ Notes:
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | Short description of this domain name. e.g. company name | `cn=Google Inc`
`name` | Short description of this domain name. e.g. company name | `name=Google Inc`
`quota` | Per-domain mailbox quota, in MB. | `quota=2048`
`language` | Default preferred language for newly created mail user | `language=en_US`
`transport` | Transport program | `transport=dovecot`
`defaultQuota` | Default per-user mailbox quota for newly created user, in MB. | `defaultQuota=1024`
`maxUserQuota` | Max mailbox quota of a mail user, in MB. | `maxUserQuota=2048`
`numberOfUsers` | Max number of mail user accounts | `numberOfUsers=20`
`numberOfAliases` | Max number of mail alias accounts | `numberOfAliases=30`
`numberOfLists` | Max number of mailing list accounts (LDAP only)| `numberOfLists=40`
`senderBcc` | Per-domain sender bcc | `senderBcc=user@domain.com`
`recipientBcc` | Per-domain recipient bcc | `recipientBcc=user@domain.com`
</div>
!!! api "`DELETE`{: .delete } `/api/domain/<domain>`{: .url } `Delete an existing domain`{: .comment }"
<!--
!!! api "`PUT`{: .put } `/api/domain/<domain>`{: .url } `Update profile of an existing domain`{: .comment } `Parameters`{: .has_params }"
!!! api "`PUT`{: .put } `/api/domain/<domain>`{: .url } `Update profile of an existing domain`{: .comment } `upcoming`{: .upcoming } `Parameters`{: .has_params }"
<div class="params params_domain">
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | Short description of this domain name. e.g. company name | `cn=Google Inc`
`name` | Short description of this domain name. e.g. company name | `name=Google Inc`
`accountStatus` | Enable or disable domain | `accountStatus=active` (or `disabled`)
`quota` | Mailbox quota for whole domain, in MB. | `quota=2048`
`language` | Default preferred language for newly created mail user | `language=en_US`
`transport` | Transport program | `transport=dovecot`
`numberOfUsers` | Max number of mail user accounts | `numberOfUsers=20`
`numberOfAliases` | Max number of mail alias accounts | `numberOfAliases=30`
`backupmx` | Mark domain as Backup MX | `backupmx=yes`
`defaultQuota` | Default per-user mailbox quota for newly created user | `defaultQuota=1024`
`maxUserQuota` | Max mailbox quota of a mail user | `maxUserQuota=2048`
`language` | Default preferred language for newly created mail user | `language=en_US`
`numberOfUsers` | Max number of mail user accounts | `numberOfUsers=20`
`numberOfAliases` | Max number of mail alias accounts | `numberOfAliases=30`
</div>
-->
### User {: .toggle }
@ -109,7 +113,7 @@ Notes:
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | Display name | `cn=My New Name`
`name` | Display name | `name=My New Name`
`password` | Password| `password=AsTr0ng@`
`language` | Preferred language of web UI | `language=en_US`
`quota` | Mailbox quota (in MB) | `quota=1024`
@ -123,7 +127,7 @@ Notes:
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | Display name | `cn=My New Name`
`name` | Display name | `name=My New Name`
`password` | Password | `password=u0tBF82cIV@vi8Gme`
`quota` | Mailbox quota (in MB) | `quota=1024`
`accountStatus` | Enable or disable user | `accountStatus=active` (or `disabled`)
@ -160,7 +164,7 @@ Notes:
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | display name | `cn=My List Name`
`name` | display name | `name=My List Name`
`accessPolicy` | Defines who can send email to this mailing list | `accessPolicy=public`
</div>
@ -173,11 +177,8 @@ Notes:
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | display name | `cn=My List Name`
<!--
`name` | display name | `name=My List Name`
`accessPolicy` | Defines who can send email to this mail alias account | `accessPolicy=public`
-->
> Note: `accessPolicy` for mail alias account is only available for SQL backends.
@ -190,7 +191,7 @@ Notes:
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | display name | `cn=My List Name`
`name` | display name | `name=My List Name`
`accessPolicy` | Defines who can send email to this mail alias account | `accessPolicy=public`
> Note: `accessPolicy` for mail alias account is only available for SQL backends.

View File

@ -50,6 +50,13 @@ To promote existing mail user `smith@test.com` to be admin of domain `test.com`:
`domainName=test.com,o=domains,dc=xx,dc=xx`), add LDAP attribute/value pair:
`domainAdmin=smith@test.com`.
## Mark user as global domain admin with iRedAdmin-Pro
With iRedAdmin-Pro, you can mark user as either global domain admin or normal
domain admin in user profile page, under tab `General`.
![](../images/iredadmin/user_profile_general.png)
## See also
* [Reset user password](./reset.user.password.html)

View File

@ -1,40 +0,0 @@
# SQL: Mark existing mail user as global domain admin
[TOC]
### Mark user as global domain admin with iRedAdmin-Pro
With iRedAdmin-Pro, you can mark user as either global domain admin or normal
domain admin in user profile page, under tab `General`.
![](../images/iredadmin/user_profile_general.png)
### Mark user as global domain admin with SQL command line tool
> If you don't have any mail account, please follow this tutorial to create a
> new mail user: [SQL: Bulk create mail users](./sql.bulk.create.mail.users.html).
Let's say you want to mark existing user `user@mydomain.com` as global domain
admin, please follow steps below to achieve this.
* Login to SQL server as either SQL root user or `vmailadmin` user.
* About SQL root user:
* for MySQL or MariaDB: SQL root user is `root`.
* for PostgreSQL: it's system account `postgres` on Linux, or
`postgresql` on FreeBSD, or `_pgsql` on OpenBSD.
* You can find their passwords in file `iRedMail.tips` under iRedMail
installation directory. for example, `/root/iRedMail-0.9.3/iRedMail.tips`.
* Update SQL table `vmail.mailbox` and `vmail.domain_admins` to mark this user
as global domain admin:
```
sql> UPDATE mailbox SET isadmin=1,isglobaladmin=1 WHERE username='user@mydomain.com';
sql> INSERT INTO domain_admins (username, domain) VALUES ('user@mydomain.com', 'ALL');
```
Now you can login to iRedAdmin-Pro as `user@mydomain.com`, it's global domain
admin.

View File

@ -14,6 +14,7 @@
## TODO
* Separated SOGo address book for LDAP backend.
* Set correct file owner for config file of Roundcube password plugin (0600, apache/nginx).
## ChangeLog

View File

@ -38,6 +38,10 @@
#smtpd_sasl_security_options = noanonymous
</code></pre>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Con <code>smtpd_tls_auth_only = yes</code> si rende necessaria l'abilitazione di STARTTLS per una connessione sicura, Se non la volete per qualsivoglia motivo, commentatelo.</p>
</div>
<ul>
<li>decommentate le ultime 4 righe:</li>
</ul>

View File

@ -130,7 +130,6 @@
<li><a href="sql.bulk.create.mail.users.html">SQL: Bulk create mail users</a></li>
<li><a href="sql.create.catch-all.html">SQL: Add per-domain catch-all account</a></li>
<li><a href="sql.create.mail.alias.html">SQL: Add a mail alias account</a></li>
<li><a href="sql.mark.user.as.admin.html">SQL: Mark existing mail user as global domain admin</a></li>
<li><a href="sql.user.mail.forwarding.html">SQL: User mail forwarding</a></li>
<li><a href="store.spamassassin.bayes.in.sql.html">Store SpamAssassin bayes in SQL</a></li>
<li><a href="use.a.bought.ssl.certificate.html">Use a bought SSL certificate</a></li>

View File

@ -29,6 +29,7 @@
<li><a href="#enable-restful-api">Enable RESTful API</a></li>
<li><a href="#sample-code-to-interact-with-iredadmin-pro-restful-api">Sample code to interact with iRedAdmin-Pro RESTful API</a></li>
<li><a href="#apis">APIs</a><ul>
<li><a href="#changelog">ChangeLog</a></li>
<li><a href="#domain">Domain</a></li>
<li><a href="#user">User</a></li>
<li><a href="#mailing-list">Mailing List</a></li>
@ -84,6 +85,10 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
<li>replace <code>&lt;mail&gt;</code> in URL by the real email address.</li>
</ul>
<p><button type="button" class="toggle_all">Expand/Collapse All API Parameters</button></p>
<h3 id="changelog">ChangeLog</h3>
<ul>
<li>Variable name <code>cn</code> has been renamed to <code>name</code>.</li>
</ul>
<h3 class="toggle" id="domain">Domain</h3>
<!--
!!! api "`GET`{: .get } `/api/domain/<domain>`{: .url } `Get profile of an existing domain`{: .comment }"
@ -103,9 +108,9 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
</thead>
<tbody>
<tr>
<td><code>cn</code></td>
<td><code>name</code></td>
<td>Short description of this domain name. e.g. company name</td>
<td><code>cn=Google Inc</code></td>
<td><code>name=Google Inc</code></td>
</tr>
<tr>
<td><code>quota</code></td>
@ -118,6 +123,11 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
<td><code>language=en_US</code></td>
</tr>
<tr>
<td><code>transport</code></td>
<td>Transport program</td>
<td><code>transport=dovecot</code></td>
</tr>
<tr>
<td><code>defaultQuota</code></td>
<td>Default per-user mailbox quota for newly created user, in MB.</td>
<td><code>defaultQuota=1024</code></td>
@ -142,6 +152,16 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
<td>Max number of mailing list accounts (LDAP only)</td>
<td><code>numberOfLists=40</code></td>
</tr>
<tr>
<td><code>senderBcc</code></td>
<td>Per-domain sender bcc</td>
<td><code>senderBcc=user@domain.com</code></td>
</tr>
<tr>
<td><code>recipientBcc</code></td>
<td>Per-domain recipient bcc</td>
<td><code>recipientBcc=user@domain.com</code></td>
</tr>
</tbody>
</table>
</div>
@ -150,27 +170,74 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
<div class="admonition api">
<p class="admonition-title"><code class="delete">DELETE</code> <code class="url">/api/domain/&lt;domain&gt;</code> <code class="comment">Delete an existing domain</code></p>
</div>
<!--
!!! api "`PUT`{: .put } `/api/domain/<domain>`{: .url } `Update profile of an existing domain`{: .comment } `Parameters`{: .has_params }"
<div class="admonition api">
<p class="admonition-title"><code class="put">PUT</code> <code class="url">/api/domain/&lt;domain&gt;</code> <code class="comment">Update profile of an existing domain</code> <code class="upcoming">upcoming</code> <code class="has_params">Parameters</code></p>
<div class="params params_domain">
<div class="params params_domain">
Parameter Name | Summary | Sample Usage
--- |--- |---
`cn` | Short description of this domain name. e.g. company name | `cn=Google Inc`
`accountStatus` | Enable or disable domain | `accountStatus=active` (or `disabled`)
`quota` | Mailbox quota for whole domain, in MB. | `quota=2048`
`transport` | Transport program | `transport=dovecot`
`numberOfUsers` | Max number of mail user accounts | `numberOfUsers=20`
`numberOfAliases` | Max number of mail alias accounts | `numberOfAliases=30`
`backupmx` | Mark domain as Backup MX | `backupmx=yes`
`defaultQuota` | Default per-user mailbox quota for newly created user | `defaultQuota=1024`
`maxUserQuota` | Max mailbox quota of a mail user | `maxUserQuota=2048`
`language` | Default preferred language for newly created mail user | `language=en_US`
</div>
-->
<table>
<thead>
<tr>
<th>Parameter Name</th>
<th>Summary</th>
<th>Sample Usage</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>name</code></td>
<td>Short description of this domain name. e.g. company name</td>
<td><code>name=Google Inc</code></td>
</tr>
<tr>
<td><code>accountStatus</code></td>
<td>Enable or disable domain</td>
<td><code>accountStatus=active</code> (or <code>disabled</code>)</td>
</tr>
<tr>
<td><code>quota</code></td>
<td>Mailbox quota for whole domain, in MB.</td>
<td><code>quota=2048</code></td>
</tr>
<tr>
<td><code>language</code></td>
<td>Default preferred language for newly created mail user</td>
<td><code>language=en_US</code></td>
</tr>
<tr>
<td><code>transport</code></td>
<td>Transport program</td>
<td><code>transport=dovecot</code></td>
</tr>
<tr>
<td><code>backupmx</code></td>
<td>Mark domain as Backup MX</td>
<td><code>backupmx=yes</code></td>
</tr>
<tr>
<td><code>defaultQuota</code></td>
<td>Default per-user mailbox quota for newly created user</td>
<td><code>defaultQuota=1024</code></td>
</tr>
<tr>
<td><code>maxUserQuota</code></td>
<td>Max mailbox quota of a mail user</td>
<td><code>maxUserQuota=2048</code></td>
</tr>
<tr>
<td><code>numberOfUsers</code></td>
<td>Max number of mail user accounts</td>
<td><code>numberOfUsers=20</code></td>
</tr>
<tr>
<td><code>numberOfAliases</code></td>
<td>Max number of mail alias accounts</td>
<td><code>numberOfAliases=30</code></td>
</tr>
</tbody>
</table>
</div>
</div>
<h3 class="toggle" id="user">User</h3>
<div class="admonition api">
<p class="admonition-title"><code class="post">POST</code> <code class="url">/api/user/&lt;mail&gt;</code> <code class="comment">Create a new mail user</code> <code class="has_params">Parameters</code></p>
@ -186,9 +253,9 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
</thead>
<tbody>
<tr>
<td><code>cn</code></td>
<td><code>name</code></td>
<td>Display name</td>
<td><code>cn=My New Name</code></td>
<td><code>name=My New Name</code></td>
</tr>
<tr>
<td><code>password</code></td>
@ -227,9 +294,9 @@ RESTFUL_API_CLIENTS = ['172.16.244.1', ...]
</thead>
<tbody>
<tr>
<td><code>cn</code></td>
<td><code>name</code></td>
<td>Display name</td>
<td><code>cn=My New Name</code></td>
<td><code>name=My New Name</code></td>
</tr>
<tr>
<td><code>password</code></td>
@ -320,9 +387,9 @@ please use mail alias account as mailing list.</p>
</thead>
<tbody>
<tr>
<td><code>cn</code></td>
<td><code>name</code></td>
<td>display name</td>
<td><code>cn=My List Name</code></td>
<td><code>name=My List Name</code></td>
</tr>
<tr>
<td><code>accessPolicy</code></td>
@ -349,16 +416,17 @@ please use mail alias account as mailing list.</p>
</thead>
<tbody>
<tr>
<td><code>cn</code></td>
<td><code>name</code></td>
<td>display name</td>
<td><code>cn=My List Name</code></td>
<td><code>name=My List Name</code></td>
</tr>
<tr>
<td><code>accessPolicy</code></td>
<td>Defines who can send email to this mail alias account</td>
<td><code>accessPolicy=public</code></td>
</tr>
</tbody>
</table>
<!--
<code>accessPolicy</code> | Defines who can send email to this mail alias account | <code>accessPolicy=public</code>
-->
<blockquote>
<p>Note: <code>accessPolicy</code> for mail alias account is only available for SQL backends.</p>
</blockquote>
@ -382,9 +450,9 @@ please use mail alias account as mailing list.</p>
</thead>
<tbody>
<tr>
<td><code>cn</code></td>
<td><code>name</code></td>
<td>display name</td>
<td><code>cn=My List Name</code></td>
<td><code>name=My List Name</code></td>
</tr>
<tr>
<td><code>accessPolicy</code></td>

View File

@ -25,6 +25,7 @@
<li><a href="#ldap-backends">LDAP backends</a></li>
</ul>
</li>
<li><a href="#mark-user-as-global-domain-admin-with-iredadmin-pro">Mark user as global domain admin with iRedAdmin-Pro</a></li>
<li><a href="#see-also">See also</a></li>
</ul>
</li>
@ -71,6 +72,10 @@ sql&gt; INSERT INTO domain_admins (username, domain) VALUES ('smith@test.com', '
<code>domainAdmin=smith@test.com</code>.</p>
</li>
</ol>
<h2 id="mark-user-as-global-domain-admin-with-iredadmin-pro">Mark user as global domain admin with iRedAdmin-Pro</h2>
<p>With iRedAdmin-Pro, you can mark user as either global domain admin or normal
domain admin in user profile page, under tab <code>General</code>.</p>
<p><img alt="" src="../images/iredadmin/user_profile_general.png" /></p>
<h2 id="see-also">See also</h2>
<ul>
<li><a href="./reset.user.password.html">Reset user password</a></li>

View File

@ -1,79 +0,0 @@
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>SQL: Mark existing mail user as global domain admin</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="/index.html" target="_blank">
<img alt="iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"
/>&nbsp;
<span>iRedMail</span>
</a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="sql-mark-existing-mail-user-as-global-domain-admin">SQL: Mark existing mail user as global domain admin</h1>
<div class="toc">
<ul>
<li><a href="#sql-mark-existing-mail-user-as-global-domain-admin">SQL: Mark existing mail user as global domain admin</a><ul>
<li><a href="#mark-user-as-global-domain-admin-with-iredadmin-pro">Mark user as global domain admin with iRedAdmin-Pro</a></li>
<li><a href="#mark-user-as-global-domain-admin-with-sql-command-line-tool">Mark user as global domain admin with SQL command line tool</a></li>
</ul>
</li>
</ul>
</div>
<h3 id="mark-user-as-global-domain-admin-with-iredadmin-pro">Mark user as global domain admin with iRedAdmin-Pro</h3>
<p>With iRedAdmin-Pro, you can mark user as either global domain admin or normal
domain admin in user profile page, under tab <code>General</code>.</p>
<p><img alt="" src="../images/iredadmin/user_profile_general.png" /></p>
<h3 id="mark-user-as-global-domain-admin-with-sql-command-line-tool">Mark user as global domain admin with SQL command line tool</h3>
<blockquote>
<p>If you don't have any mail account, please follow this tutorial to create a
new mail user: <a href="./sql.bulk.create.mail.users.html">SQL: Bulk create mail users</a>.</p>
</blockquote>
<p>Let's say you want to mark existing user <code>user@mydomain.com</code> as global domain
admin, please follow steps below to achieve this.</p>
<ul>
<li>
<p>Login to SQL server as either SQL root user or <code>vmailadmin</code> user.</p>
<ul>
<li>
<p>About SQL root user:</p>
<ul>
<li>for MySQL or MariaDB: SQL root user is <code>root</code>.</li>
<li>for PostgreSQL: it's system account <code>postgres</code> on Linux, or
<code>postgresql</code> on FreeBSD, or <code>_pgsql</code> on OpenBSD.</li>
</ul>
</li>
<li>
<p>You can find their passwords in file <code>iRedMail.tips</code> under iRedMail
installation directory. for example, <code>/root/iRedMail-0.9.3/iRedMail.tips</code>.</p>
</li>
</ul>
</li>
<li>
<p>Update SQL table <code>vmail.mailbox</code> and <code>vmail.domain_admins</code> to mark this user
as global domain admin:</p>
</li>
</ul>
<pre><code>sql&gt; UPDATE mailbox SET isadmin=1,isglobaladmin=1 WHERE username='user@mydomain.com';
sql&gt; INSERT INTO domain_admins (username, domain) VALUES ('user@mydomain.com', 'ALL');
</code></pre>
<p>Now you can login to iRedAdmin-Pro as <code>user@mydomain.com</code>, it's global domain
admin.</p><div class="footer">
<p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://bitbucket.org/zhb/iredmail-docs/get/tip.tar.bz2">download the latest version</a> for offline reading. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div>
<script type="text/javascript">
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
</script>
</body></html>

View File

@ -45,6 +45,7 @@ check <a href="../support.html">the details</a> and <a href="../contact.html">co
<h2 id="todo">TODO</h2>
<ul>
<li>Separated SOGo address book for LDAP backend.</li>
<li>Set correct file owner for config file of Roundcube password plugin (0600, apache/nginx).</li>
</ul>
<h2 id="changelog">ChangeLog</h2>
<ul>

View File

@ -19,6 +19,9 @@ Sin dalla versione 0.9.5 di iRedMail, l'autenticazione su porta 25 è disabilita
#smtpd_sasl_security_options = noanonymous
```
!!! note
Con `smtpd_tls_auth_only = yes` si rende necessaria l'abilitazione di STARTTLS per una connessione sicura, Se non la volete per qualsivoglia motivo, commentatelo.
* decommentate le ultime 4 righe:
```