- DL manuals
- IBM
- Gateway
- DFS
- Reference Manual
IBM DFS Reference Manual - 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 editions.
Order publications through your IBM representative or through the IBM branch office serving your locality.
© Copyright International Business Machines Corporation 1989, 1999. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
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