usr/src/man/man4/ike.preshared.4

   1 '\" te
   2 .\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH IKE.PRESHARED 4 "Oct 15, 2001"
   7 .SH NAME
   8 ike.preshared \- pre-shared keys file for IKE
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/etc/inet/secret/ike.preshared\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18  The \fB/etc/inet/secret/ike.preshared\fR file contains secret keying material
  19 that two \fBIKE\fR instances can use to authenticate each other. Because of the
  20 sensitive nature of this data, it is kept in the \fB/etc/inet/secret\fR
  21 directory, which is only accessible by root.
  22 .sp
  23 .LP
  24 Pre-shared keys are delimited by open-curly-brace (\fB{\fR) and
  25 close-curly-brace (\fB}\fR) characters. There are five name-value pairs
  26 required inside a pre-shared key:
  27 .sp
  28
  29 .sp
  30 .TS
  31 c c c
  32 l l l .
  33 Name    Value   Example
  34 localidtype     IP      localidtype IP
  35 remoteidtype    IP      remoteidtype IP
  36 localid IP-address      localid 10.1.1.2
  37 remoteid        IP-address      remoteid 10.1.1.3
  38 key     hex-string              1234567890abcdef
  39 .TE
  40
  41 .sp
  42 .LP
  43 Comment lines with \fB#\fR appearing in the first column are also legal.
  44 .sp
  45 .LP
  46 Files in this format can also be used by the \fBikeadm\fR(1M) command to load
  47 additional pre-shared keys into a running an \fBin.iked\fR(1M) process.
  48 .SH EXAMPLES
  49 .LP
  50 \fBExample 1 \fRA Sample ike.preshared File
  51 .sp
  52 .LP
  53 The following is an example of an \fBike.preshared\fR file:
  54
  55 .sp
  56 .in +2
  57 .nf
  58
  59 #
  60 # Two pre-shared keys between myself, 10.1.1.2, and two remote
  61 # hosts.  Note that names are not allowed for IP addresses.
  62 #
  63 # A decent hex string can be obtained by performing:
  64 #           od -x </dev/random | head
  65 #
  66
  67 {
  68     localidtype IP
  69     localid 10.1.1.2
  70     remoteidtype IP
  71     remoteid 10.21.12.4
  72     key 4b656265207761732068657265210c0a
  73 }
  74
  75 {
  76    localidtype IP
  77    localid 10.1.1.2
  78    remoteidtype IP
  79    remoteid 10.9.1.25
  80    key 536f20776572652042696c6c2c2052656e65652c20616e642043687269732e0a
  81 }
  82 .fi
  83 .in -2
  84
  85 .SH SECURITY
  86 .sp
  87 .LP
  88 If this file is compromised, all \fBIPsec\fR security associations derived from
  89 secrets in this file will be compromised as well. The default permissions on
  90 \fBike.preshared\fR are \fB0600\fR. They should stay this way.
  91 .SH SEE ALSO
  92 .sp
  93 .LP
  94 \fBod\fR(1), \fBikeadm\fR(1M), \fBin.iked\fR(1M), \fBipseckey\fR(1M),
  95 \fBattributes\fR(5), \fBrandom\fR(7D)