summaryrefslogtreecommitdiff
path: root/tests/config/README
blob: cedaccf0200d25c3f77ea49db558d0a1f6b363c7 (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
This directory contains configuration required to run the complete wallet
test suite.  If there is no configuration in this directory, some of the
tests will be skipped.  To enable the full test suite, create the
following files:

keytab

    A valid Kerberos keytab for a principal, preferrably in your local
    realm.  This will be used to test network interactions that require
    Kerberos authentication.

principal

    The name of the Kerberos principal whose keys are stored in keytab.

password

    This file should contain two lines.  The first line is the
    fully-qualified principal (including the realm) of a Kerberos
    principal to use for testing authentication.  The second line is
    the password for that principal.  The realm of the principal must
    be configured in your system krb5.conf file or in DNS configuration
    picked up by your Kerberos libraries and must be in the same realm as
    the keytab above or have valid cross-realm trust to it.

If you are building in a different directory tree than the source tree,
don't put the files in this directory.  Instead, after running configure,
you will have an empty tests/config directory in your build tree.  Put the
keytab and principal files in that directory instead.

If your krb5.conf file is not in /etc or /usr/local/etc, put a copy of
your krb5.conf file in the tests/data directory.  The tests need to
generate a modified copy in order to test some behavior.

-----

Copyright 2013
    The Board of Trustees of the Leland Stanford Junior University

Copying and distribution of this file, with or without modification, are
permitted in any medium without royalty provided the copyright notice and
this notice are preserved.  This file is offered as-is, without any
warranty.