|
@@ -1,5 +1,5 @@
|
|
|
.\" Text automatically generated by txt2man
|
|
.\" Text automatically generated by txt2man
|
|
|
-.TH TURN 1 "15 July 2014" "" ""
|
|
|
|
|
|
|
+.TH TURN 1 "22 July 2014" "" ""
|
|
|
.SH GENERAL INFORMATION
|
|
.SH GENERAL INFORMATION
|
|
|
|
|
|
|
|
The \fBTURN Server\fP project contains the source code of a TURN server and TURN client
|
|
The \fBTURN Server\fP project contains the source code of a TURN server and TURN client
|
|
@@ -134,15 +134,16 @@ User database settings:
|
|
|
\fB\-b\fP, \fB\-\-userdb\fP
|
|
\fB\-b\fP, \fB\-\-userdb\fP
|
|
|
User database file name (default \- turnuserdb.conf),
|
|
User database file name (default \- turnuserdb.conf),
|
|
|
for long\-term credentials mechanism only.
|
|
for long\-term credentials mechanism only.
|
|
|
-This user file database is being dynamically checked while the \fIturnserver\fP
|
|
|
|
|
-is working, and the user accounts can be changed dynamically by
|
|
|
|
|
-editing the database.
|
|
|
|
|
|
|
+This user file database is being dynamically checked while the
|
|
|
|
|
+\fIturnserver\fP is working, and the user accounts can be changed
|
|
|
|
|
+dynamically by editing the database.
|
|
|
.TP
|
|
.TP
|
|
|
.B
|
|
.B
|
|
|
\fB\-e\fP, \fB\-\-psql\-userdb\fP
|
|
\fB\-e\fP, \fB\-\-psql\-userdb\fP
|
|
|
User database connection string for PostgreSQL.
|
|
User database connection string for PostgreSQL.
|
|
|
-This database can be used for long\-term and short\-term credentials mechanisms,
|
|
|
|
|
-and it can store the secret value for secret\-based timed authentication in TURN RESP API.
|
|
|
|
|
|
|
+This database can be used for long\-term and short\-term
|
|
|
|
|
+credentials mechanisms, and it can store the secret value
|
|
|
|
|
+for secret\-based timed authentication in TURN RESP API.
|
|
|
The connection string format is like that:
|
|
The connection string format is like that:
|
|
|
.RS
|
|
.RS
|
|
|
.PP
|
|
.PP
|
|
@@ -151,7 +152,8 @@ The connection string format is like that:
|
|
|
.PP
|
|
.PP
|
|
|
Or:
|
|
Or:
|
|
|
.PP
|
|
.PP
|
|
|
-"postgresql://username:password@hostname:port/databasename" (for 9.x or newer Postgres).
|
|
|
|
|
|
|
+"postgresql://username:password@hostname:port/databasename"
|
|
|
|
|
+(for 9.x or newer Postgres).
|
|
|
See the INSTALL file for more explanations and examples.
|
|
See the INSTALL file for more explanations and examples.
|
|
|
.PP
|
|
.PP
|
|
|
Also, see http://www.PostgreSQL.org for full PostgreSQL documentation.
|
|
Also, see http://www.PostgreSQL.org for full PostgreSQL documentation.
|
|
@@ -160,8 +162,9 @@ Also, see http://www.PostgreSQL.org for full PostgreSQL documentation.
|
|
|
.B
|
|
.B
|
|
|
\fB\-M\fP, \fB\-\-mysql\-userdb\fP
|
|
\fB\-M\fP, \fB\-\-mysql\-userdb\fP
|
|
|
User database connection string for MySQL or MariaDB.
|
|
User database connection string for MySQL or MariaDB.
|
|
|
-This database can be used for long\-term and short\-term credentials mechanisms,
|
|
|
|
|
-and it can store the secret value for secret\-based timed authentication in TURN RESP API.
|
|
|
|
|
|
|
+This database can be used for long\-term and short\-term
|
|
|
|
|
+credentials mechanisms, and it can store the secret value for
|
|
|
|
|
+secret\-based timed authentication in TURN RESP API.
|
|
|
The connection string format is like that:
|
|
The connection string format is like that:
|
|
|
.RS
|
|
.RS
|
|
|
.PP
|
|
.PP
|
|
@@ -175,12 +178,13 @@ for full MySQL documentation.
|
|
|
.B
|
|
.B
|
|
|
\fB\-J\fP, \fB\-\-mongo\-userdb\fP
|
|
\fB\-J\fP, \fB\-\-mongo\-userdb\fP
|
|
|
User database connection string for MongoDB.
|
|
User database connection string for MongoDB.
|
|
|
-This database can be used for long\-term and short\-term credentials mechanisms,
|
|
|
|
|
-and it can store the secret value for secret\-based timed authentication in TURN RESP API.
|
|
|
|
|
|
|
+This database can be used for long\-term and short\-term
|
|
|
|
|
+credentials mechanisms, and it can store the secret value
|
|
|
|
|
+for secret\-based timed authentication in TURN RESP API.
|
|
|
The connection string format is like that:
|
|
The connection string format is like that:
|
|
|
.RS
|
|
.RS
|
|
|
.PP
|
|
.PP
|
|
|
-"mongodb://[username:password@]host1[:port1][,host2[:port2],\.\.\.[,hostN[:portN]]][/[database][?\fIoptions\fP]]"
|
|
|
|
|
|
|
+"mongodb://username:password@host:port/database?\fIoptions\fP"
|
|
|
See the INSTALL file for more explanations and examples.
|
|
See the INSTALL file for more explanations and examples.
|
|
|
.PP
|
|
.PP
|
|
|
Also, see http://docs.mongodb.org/manual/
|
|
Also, see http://docs.mongodb.org/manual/
|
|
@@ -190,8 +194,9 @@ for full MongoDB documentation.
|
|
|
.B
|
|
.B
|
|
|
\fB\-N\fP, \fB\-\-redis\-userdb\fP
|
|
\fB\-N\fP, \fB\-\-redis\-userdb\fP
|
|
|
User database connection string for Redis.
|
|
User database connection string for Redis.
|
|
|
-This database can be used for long\-term and short\-term credentials mechanisms,
|
|
|
|
|
-and it can store the secret value for secret\-based timed authentication in TURN RESP API.
|
|
|
|
|
|
|
+This database can be used for long\-term and short\-term
|
|
|
|
|
+credentials mechanisms, and it can store the secret
|
|
|
|
|
+value for secret\-based timed authentication in TURN RESP API.
|
|
|
The connection string format is like that:
|
|
The connection string format is like that:
|
|
|
.RS
|
|
.RS
|
|
|
.PP
|
|
.PP
|
|
@@ -822,14 +827,15 @@ limited time by an application that has to create a TURN server connection.
|
|
|
The "classic" long\-term credentials mechanism (LTCM) is described here:
|
|
The "classic" long\-term credentials mechanism (LTCM) is described here:
|
|
|
.PP
|
|
.PP
|
|
|
http://tools.ietf.org/html/rfc5389#section\-10.2
|
|
http://tools.ietf.org/html/rfc5389#section\-10.2
|
|
|
|
|
+.PP
|
|
|
http://tools.ietf.org/html/rfc5389#section\-15.4
|
|
http://tools.ietf.org/html/rfc5389#section\-15.4
|
|
|
.PP
|
|
.PP
|
|
|
-For authentication, each user must know two things: the username and the
|
|
|
|
|
-password. Optionally, the user must supply the ORIGIN value, so that the
|
|
|
|
|
|
|
+For authentication, each user must know two things: the username and the
|
|
|
|
|
+password. Optionally, the user must supply the ORIGIN value, so that the
|
|
|
server can figure out the realm to be used for the user. The nonce and
|
|
server can figure out the realm to be used for the user. The nonce and
|
|
|
the realm values are supplied by the TURN server. But LTCM is not saying
|
|
the realm values are supplied by the TURN server. But LTCM is not saying
|
|
|
-anything about the nature and about the persistence
|
|
|
|
|
-of the username and of the password; and this is used by the REST API.
|
|
|
|
|
|
|
+anything about the nature and about the persistence of the username and
|
|
|
|
|
+of the password; and this is used by the REST API.
|
|
|
.PP
|
|
.PP
|
|
|
In the TURN REST API, there is no persistent passwords for users. A user has
|
|
In the TURN REST API, there is no persistent passwords for users. A user has
|
|
|
just the username. The password is always temporary, and it is generated by
|
|
just the username. The password is always temporary, and it is generated by
|
|
@@ -1125,8 +1131,7 @@ http://code.google.com/p/coturn/wiki/Readme
|
|
|
.PP
|
|
.PP
|
|
|
forum:
|
|
forum:
|
|
|
.PP
|
|
.PP
|
|
|
-https://groups.google.com/forum/?fromgroups=#!forum/turn\-server\-project\-rfc5766\-turn\-server/
|
|
|
|
|
-.RE
|
|
|
|
|
|
|
+https://groups.google.com/forum/?fromgroups=#!forum/turn\-server\-project\-rfc5766\-turn\-server
|
|
|
.PP
|
|
.PP
|
|
|
======================================
|
|
======================================
|
|
|
.SS AUTHORS
|
|
.SS AUTHORS
|