1. DL manuals
  2. IBM
  3. Gateway
  4. DFS
  5. Reference Manual

IBM DFS Reference Manual

Manual is about: IBM NFS/DFS Secure Gateway Guide and Reference

Summary of DFS

  • Page 1

    Dfs for solaris nfs/dfs secure gateway guide and reference version 3.1 gc09-3993-00

  • Page 3

    Dfs for solaris nfs/dfs secure gateway guide and reference version 3.1 gc09-3993-00

  • Page 4

    Note before using this information and the product it supports, be sure to read the general information under “notices” on page 49. First edition (april 2000) this edition applies to: dfs for solaris, version 3.1 and to all subsequent releases and modifications until otherwise indicated in new editi...

  • Page 5: Contents

    Contents preface . . . . . . . . . . . . . V audience . . . . . . . . . . . . V applicability . . . . . . . . . . . V purpose . . . . . . . . . . . . . V document organization . . . . . . . V related documents . . . . . . . . . Vi typographic and keying conventions. . . Vi chapter 1. Overview of the...

  • Page 6

    Iv dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 7: Preface

    Preface the ibm dfs for solaris nfs/dfs secure gateway guide and reference contains guide and reference information about the nfs/dfs secure gateway for solaris, which provides authenticated access to the dfs filespace to clients of the network file system (nfs) by associating an nfs request with an...

  • Page 8

    Related documents for information about dce in general, and dce administration for solaris in particular, refer to the following documents: v ibm distributed computing environment for solaris: quick beginnings v ibm distributed computing environment for aix and solaris: administration guide - introd...

  • Page 10

    Viii dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 11

    Chapter 1. Overview of the nfs/dfs secure gateway the network file system (nfs) to dfs secure gateway provides a mechanism for granting authenticated access to the dfs filespace from an nfs client. The nfs/dfs secure gateway enables users to access data in the dfs filespace from a machine that is co...

  • Page 12

    On the gateway server machines, installing the vendor-provided dfs_login and dfs_logout commands on the nfs clients, configuring kerberos on the nfs clients, and configuring the remote authentication service on both the gateway server machines and the nfs clients. However, authentication requires no...

  • Page 13

    Before establishing a new mapping between a remote user and dce principal, the existing mapping must be deleted. A user who wants to end an authenticated session to dfs before the credentials expire can issue either the dfs_logout command from the nfs client for which the credentials were granted or...

  • Page 14

    4 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 15

    Chapter 2. Configuring gateway server machines a gateway server machine provides authenticated access to the dfs filespace to users on nfs clients. You can configure any machine that is configured as a dfs client and an nfs server as a gateway server. Following successful configuration, the machine ...

  • Page 16

    Before configuring a gateway server machine, you must do the following: v configure a dce cell that includes dfs. V configure each machine that is to become a gateway server as a dfs client and an nfs server. V ensure proper synchronization among the system clocks on machines that are to become gate...

  • Page 17

    Configuring a gateway server and enabling remote authentication perform the steps in this section to enable dce authentication either from a gateway server machine or from nfs clients that contact the gateway server. Users authenticate from the gateway server machine by issuing the dfsgw add command...

  • Page 18

    $ dcecp dcecp> principal create hosts/hostname/dfs-server dcecp> account create hosts/hostname/dfs-server -group subsys/dce/dfs-admin -org none -password password mypwd password 3. Grant the group subsys/dce/dfs-admin the appropriate permissions on the acl for the hosts/hostname/dfs-server principal...

  • Page 19

    Configuring the gateway server process to configure the gateway server (dfsgwd) process, perform the following steps on the machine to be configured as a gateway server. The steps assume that the bos server is already running on the machine. In all of the steps, hostname is the hostname of the local...

  • Page 20

    V the m, a, u, and g permissions on the principal hosts/hostnamedfsgw- server . The principal is created during the configuration steps. V the t and m permissions on the group subsys/dce/dfsgw-admin. The group is created during the configuration steps. V the r, t, and m permissions on the organizati...

  • Page 21

    13. Create a simple bos server process named dfsgw to run the dfsgwd server process: $ dcelocal/bin/bos create -server /.:/hosts/hostname -process dfsgw -type simple -cmd dcelocal/bin/dfsgwd the gateway server process is now fully configured on the machine. Chapter 2. Configuring gateway server mach...

  • Page 22

    12 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 23

    Chapter 3. Configuring nfs clients to access dfs after you have configured at least one gateway server machine according to the instructions in “chapter 2. Configuring gateway server machines” on page 5, you can configure your nfs clients to provide access to the dfs filespace. Users who have dce ac...

  • Page 24

    Configuring a client without enabling remote authentication if you configured your gateway server machines so that users cannot issue the dfs_login command to authenticate to dce, perform the steps in this section to configure your nfs clients. The steps enable dfs access from an nfs client without ...

  • Page 25

    Note: the dfs_login and dfs_logout commands are not provided with dfs; these commands can be used only if they are available from your nfs vendor. If these commands are not available, use the dfsgw add and dfsgw delete commands, which work in a similar fashion. See your nfs vendor documentation for ...

  • Page 26

    .Def.Com abc.Com 6. If you use the /etc/services file in your environment, add the following entry for the dfsgw service to the /etc/services file on the machine: dfsgw 438/udp dlog where dfsgw is the name of the service, 438 is the port at which the service receives rpcs, udp is the protocol the se...

  • Page 27

    Chapter 4. Accessing dfs from an nfs client after a gateway server machine and one or more nfs clients are configured according to the instructions in “chapter 2. Configuring gateway server machines” on page 5 and “chapter 3. Configuring nfs clients to access dfs” on page 13, users of the nfs client...

  • Page 28

    When an unauthenticated user creates an object, the object is owned by the user nobody and the group nogroup. The uid of the user nobody is -2, and the gid of the group nogroup is also -2. (identities and id numbers of an unauthenticated user and group can vary between systems; see your vendor’s doc...

  • Page 29

    The dfsgw add command can be used to refresh dce credentials. If they are not refreshed, dce credentials (tickets) expire after the lifetime specified by the dce security service. After they expire, the tickets can no longer be used for authenticated access. To end an authenticated session before th...

  • Page 30

    Given for the dfs_login and dfs_logout commands can only be performed if your nfs vendor provides these commands. If these commands are not available, use the instructions for the dfsgw add and dfsgw delete commands, which work in a similar fashion. See your nfs vendor documentation for the availabi...

  • Page 31

    To end the authenticated session before the dce credentials expire, issue the dfs_logout command from the nfs client. The command removes the user’s entry from the authentication table on the gateway server machine. The command can be issued either by the user whose entry is to be removed from the a...

  • Page 32

    Provides the same functionality from a gateway server machine that the dfs_logout command provides from an nfs client. The dfsgw delete command can be issued either by the user whose entry is to be removed from the authentication table or by a user who is logged into the gateway server machine as th...

  • Page 33

    Who has dfs access, and the date and time at which each user’s dce credentials expire. See the reference page for the dfsgw list command for more information about the command. Chapter 4. Accessing dfs from an nfs client 23.

  • Page 34

    24 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 35

    Chapter 5. Configuration file and command reference this chapter contains configuration file and command reference information for the nfs/dfs secure gateway. © copyright ibm corp. 1989, 1999 25.

  • Page 36

    Dfsgwlog purpose log file that contains messages generated by the gateway server process of the nfs/dfs secure gateway description the dfsgwlog file contains messages generated by the gateway server (dfsgwd) process. The gateway server process runs on machines configured as dfs clients to allow user...

  • Page 37

    Dfsgw purpose introduction to the dfsgw command suite used with the nfs/dfs secure gateway options the following options are used with many dfsgw commands. They are also described with the commands that use them. -id networkid:userid identifies an nfs client and the user whose dce authentication fro...

  • Page 38

    Dfsgw list displays a list of users who are authenticated to dce via the gateway server machine. Dfsgw query determines whether a specific user is authenticated to dce via the gateway server machine. The command determines the user’s entry in the authentication table, if it exists. Commands in the d...

  • Page 39

    Related information commands: dfsgw_add(8dfs) dfsgw_apropos(8dfs) dfsgw_delete(8dfs) dfsgw_help(8dfs) dfsgw_list(8dfs) dfsgw_query(8dfs) dfs_intro(8dfs) chapter 5. Configuration file and command reference 29.

  • Page 40

    Dfsgw add purpose adds an entry to the authentication table on the gateway server machine synopsis dfsgw add -id networkid:userid [-dceid login_name[:password]] [-sysname sysname] [-remotehost name] [-af address_family] [-help] options -id networkid:userid identifies an nfs client and the user who i...

  • Page 41

    Description the dfsgw add command authenticates a user to dce. The command contacts the dce security service to obtain a tgt for the user. To obtain a tgt, a user must have a valid account in the registry database of the dce cell. The tgt is used to create a valid login context for the user. The log...

  • Page 42

    Output the dfsgw add command displays the following prompts to request a dce principal and password: enter principal name: principal enter password: password where principal is the name of the user to be authenticated to dce, and password is the password of the named user; you supply both of these v...

  • Page 43

    Dfsgw apropos purpose displays the help entry for each dfsgw command that contains a specified string synopsis dfsgw apropos -topic string [-help] options -topic string specifies the keyword string for which to search. If it is more than a single word, surround the string with double quotes ( ″ ″) o...

  • Page 44

    Related information commands: dfsgw help(8dfs) 34 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 45

    Dfsgw delete purpose removes an entry from the authentication table on the gateway server machine synopsis dfsgw delete -id networkid:userid [-af address_family] [-help] options -id networkid:userid identifies an nfs client and the user whose authentication to dce from that client is to be canceled....

  • Page 46

    Privilege required the issuer must be logged into the gateway server machine either as the user whose entry is to be removed from the authentication table or as the local superuser root. Examples the following command deletes the entry from the authentication table that grants authenticated access t...

  • Page 47

    Dfsgw help purpose shows syntax of specified dfsgw commands or lists functional descriptions of all dfsgw commands synopsis dfsgw help [-topic string] [-help] options -topic string specifies each command whose syntax is to be displayed. Provide only the second part of the command name (for example, ...

  • Page 48

    Dfsgw list: list all entries in the at usage: dfsgw list [-help] related information commands: dfsgw apropos(8dfs) 38 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 49

    Dfsgw list purpose lists all entries in the authentication table on the gateway server machine synopsis dfsgw list [-help] options -help displays help information for this command. Description the dfsgw list command lists all entries from the local authentication table, which indicate which users on...

  • Page 50

    Hostname names the nfs client for which the entry grants authenticated access to dfs principal displays the principal name of the user to whom the entry grants authenticated access pag identifies the process activation group (pag) that exists for the hostname/principal pair date/time specifies the d...

  • Page 51

    Dfsgw_delete(8dfs) dfsgw_query(8dfs) chapter 5. Configuration file and command reference 41.

  • Page 52

    Dfsgw query purpose queries the authentication table on the gateway server machine synopsis dfsgw query -id networkid:userid [-af address_family] [-help] options -id networkid:userid identifies an nfs client and the user whose authentication from the client is to be determined. Specify either the ne...

  • Page 53

    Privilege required the issuer must be logged into the gateway server machine either as the user whose entry in the authentication table is to be examined or as the local superuser root. Output the dfsgw query command displays the following line of output if the specified user has an entry for the sp...

  • Page 54

    Dfsgwd purpose initializes the gateway server process for the nfs/dfs secure gateway synopsis dfsgwd [-service service_number] [-sysname sysname] [-nodomains] [-file log_file] [-verbose] [-help] options -service service_number specifies the port number to be used to communicate with the dfsgwd proce...

  • Page 55

    Description the dfsgwd command initializes the gateway server process. The dfsgwd process runs on machines configured as dfs clients to enable remote authentication via the dfs_login command. The dfsgwd process works with the dfs_login command to obtain dce credentials for users of nfs clients. The ...

  • Page 56

    Privileges required the issuer must be the local superuser root on the local machine. Files dcelocal/var/dfs/adm/dfsgwlog the default log file for the dfsgwd process. You can use the -file option to specify a different pathname for the log file. Related information commands: bos getlog(8dfs) bosserv...

  • Page 57: Index

    Index special characters @sys and @host variables 44, 45 a acl permissions 7, 9 authenticating to dce determining whether a specific user is authenticated 22 displaying information about all authenticated users 22 local 1 remote 1 b bos server 9 bosserver process 8 configuring 7 bosconfig file 8 c c...

  • Page 58

    48 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 59: Notices

    Notices first edition (april 2000) this information was developed for products and services offered in the u.S.A. Ibm may not offer the products, services, or features discussed in this document in other countries. Consult your local ibm representative for information on the products and services cu...

  • Page 60

    This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the document. Ibm may make improvements and/or changes in the product(s) and/or the program(s) described in th...

  • Page 61

    All statements regarding ibm’s future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. All ibm prices show are ibm’s suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information...

  • Page 62

    Unix is a registered trademark in the united states, other countries or both and is licensed exclusively through x/open company limited. Other company, product, and service names may be trademarks or service marks of others. 52 dfs for solaris: nfs/dfs secure gateway guide and reference.

  • Page 63

    Readers’ comments — we’d like to hear from you dfs for solaris nfs/dfs secure gateway guide and reference version 3.1 publication no. Gc09-3993-00 overall, how satisfied are you with the information in this book? Very satisfied satisfied neutral dissatisfied very dissatisfied overall satisfaction h ...

  • Page 64: Business Reply Mail

    Readers’ comments — we’d like to hear from you gc09-3993-00 gc09-3993-00 cut or fold along line cut or fold along line fold and tape please do not staple fold and tape fold and tape please do not staple fold and tape no postage necessary if mailed in the united states business reply mail first-class...

  • Page 66

    Program number: printed in the united states of america on recycled paper containing 10% recovered post-consumer fiber. Gc09-3993-00

  • Page 67

    Spine information: dfs for solaris nfs/dfs secure gateway guide and reference version 3.1 gc09-3993-00