home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_s_z / draft-smith-java-appl-00.txt < prev    next >
Text File  |  1996-12-23  |  29KB  |  788 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                   T.G.Smith
  8. INTERNET-DRAFT                                     Gecko Software
  9. Expire in six months                             20 November 1996
  10.  
  11.                 Orbit Shadow TM - Data Transport Protocol
  12.                                   for
  13.                      Java Thin Client Applications
  14.                                to access
  15.                       Network Management Platforms
  16.  
  17.                      <draft-smith-java-appl-00.txt>
  18.  
  19.    _1.  _S_t_a_t_u_s _o_f _t_h_i_s _M_e_m_o
  20.  
  21.    This document is an Internet-Draft. Internet-Drafts are working docu-
  22.    ments of the Internet Engineering Task Force (IETF), its areas, and
  23.    its working groups. Note the other groups may also distribute working
  24.    documents as Internet-Drafts.
  25.  
  26.    Internet Drafts are draft documents valid for a maximum of six months
  27.    and may be updated, replaced, or obsoleted by other documents at any
  28.    time. It is inappropriate to use Internet-Drafts as reference
  29.    material or to cite the other than as "work in progress".
  30.  
  31.    To learn the current status of any Internet-Draft, please check the
  32.    "lid-abstracts.txt" listing contained in the Internet-Drafts Shadow
  33.    Directories on ftp.is.oc.za (Africa), nic.nordu.net (Europe),
  34.    munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  35.    ftp.isi.edu (US West Coast).
  36.  
  37.    _2.  _A_b_s_t_r_a_c_t
  38.  
  39.    _2._1.  _I_n_t_e_r_e_s_t
  40.  
  41.    This document is of interest to vendors of network management platforms
  42.    and network management applications, for the management of intranets,
  43.    private internetworks and the public Internet.
  44.  
  45.    _2._2.  _S_t_a_t_u_s _R_e_p_o_r_t
  46.  
  47.    This is the first submission of this RFC.
  48.  
  49.    _2._3.  _P_r_o_t_o_c_o_l
  50.  
  51.    This protocol is an application layer protocol for the interchange of
  52.    data between a network management server and a network management
  53.    client application. The protocol is intended to be used in operating
  54.    system independant implementations of "thin" client applications.
  55.    This protocol is currently implemented by one manufacturer - Gecko
  56.  
  57.  
  58.  
  59. Smith                                                   FORMFEED[Page 1]
  60.  
  61.  
  62.  
  63.  
  64.  
  65. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  66.  
  67.  
  68.    Software, but is being placed in the public domain as it is of
  69.    interest to other manufacturers dealing with network management
  70.    issues.
  71.  
  72.    _3.  _I_n_t_r_o_d_u_c_t_i_o_n _t_o _O_R_B_I_T
  73.  
  74.                   A GeckoWare product from Gecko Software
  75.  
  76.    ORBIT is an architecture that integrates information technology
  77.    management platforms, the World Wide Web, HTML browser applications
  78.    and Java  to provide operating system independant access to mission
  79.    critical management information.  Designed to be used with enterprise
  80.    systems and network management platforms such as
  81.  
  82.  
  83.                   SPECTRUM         from Cabletron Systems
  84.                   HP OpenView      from Hewlett Packard
  85.                   SunNET Manager   from Sun Microsystems
  86.  
  87.  
  88.    ORBIT  Planet provides a public domain Java API to access information
  89.    on a remote management platform, using the ORBIT  Star server. The
  90.    ORBIT  Star and Satellite are Java powered, and communicate using
  91.    ORBIT  Shadow an application layer protocol that is implemented using
  92.    TCP/IP sockets.  Any Java compatabile application, specifically HTML
  93.    browsers, can implement Java applets that access management applica-
  94.    tion information through ORBIT Planet, Shadow and Star.
  95.  
  96.    _3._1.  _O_R_B_I_T  _S_t_a_r
  97.  
  98.    A server application (daemon) that co-exists with the management
  99.    application, or remote from the management application where sup-
  100.    ported by the API or CLI. ORBIT Star accepts API or CLI calls from
  101.    one or more ORBIT Satellites vi a ORBIT  Shadow. These calls are
  102.    passed to the management application by ORBIT Star and the results
  103.    passed back to the relevant ORBIT Planet.
  104.  
  105.    _3._2.  _O_R_B_I_T  _P_l_a_n_e_t
  106.  
  107.    A public domain Java package, consisting of class, method and inter-
  108.    face definitions that implement the Application Program Interfaces or
  109.    Command Line Interfaces of a management application. Communication
  110.    with a management application is through ORBIT  Shadow to an ORBIT
  111.    Star.
  112.  
  113.    _3._3.  _O_R_B_I_T  _S_h_a_d_o_w
  114.  
  115.    An application layer protocol, implemented uding TCP/IP sockets, that
  116.  
  117.  
  118.  
  119. Smith                                                   FORMFEED[Page 2]
  120.  
  121.  
  122.  
  123.  
  124.  
  125. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  126.  
  127.  
  128.    controls data requests and responses between ORBIT  Stars and ORBIT
  129.    Planets.
  130.  
  131.  
  132.    _4.  _U_s_e _C_a_s_e _f_o_r _O_r_b_i_t _S_h_a_d_o_w
  133.  
  134.    An example of the application of Orbit Shadow is given as a use case.
  135.    In this use case, the Orbit implementation is Orbit for SPECTRUMr,
  136.    Cabletron Systems, Inc, enterprise management system.  Fred, a net-
  137.    work Manager, wishes to be able to view the state of all Cisco
  138.    routers in his company's network using the Netscape browser that he
  139.    has installed on his Apple Macintosh.  Fred asks Cathy, an applica-
  140.    tion programmer, to build him an application to perform this func-
  141.    tion.
  142.  
  143.    Cathy designs a series of Java applets that Fred will access from an
  144.    page on their corporate WWW server. One of the applets that she
  145.    writes needs to be able to query the state of a specific router (a
  146.    managed object).Cathy uses Orbit Planet as the interface to interro-
  147.    gate a SPECTRUM system, installed on their network, as to the state
  148.    of the required router.
  149.  
  150.    Orbit Planet (a public domain Java package) provides Cathy with
  151.    object classes, methods and interfaces to interrogate and update her
  152.    SPECTRUM server, using an Orbit Star application on the SpectroSERVER
  153.    host[1]. Cathy includes the Orbit Planet Java packages in her applet
  154.    that needs to be able to query the state of a specific router. When
  155.    the relevant method is invoked[2] Orbit Shadow packages the request
  156.    into an Orbit Shadow protocol frame and communicates the request to
  157.    the relevant Orbit Star.  From the above, you can see that Orbit Sha-
  158.    dow is embedded in Orbit Planet. There is also a corresponding Orbit
  159.    Shadow embedded in Orbit Star. When this Orbit Shadow receives the
  160.    request from Cathy's applet, it executes the request and returns the
  161.    data to the applet. To execute the request, Orbit Star calls the
  162.    relevant SPECTRUM interface[3], parses and formats the resulting out-
  163.    put before handing the data to Orbit Shadow. Orbit Shadow packages
  164.    the data into an Orbit Shadow protocol frame and communicates the
  165.    response to the relevant Orbit Planet.
  166.  
  167.  
  168.    END-NOTES
  169.    ---------
  170.    1       Orbit Star - SPECTRUM does not necessarily have to co-
  171.    reside with a SpectroSERVER. V1.x of Orbit Star - SPECTRUM
  172.    uses the SPECTRUM Command Line Interface and can reside on a
  173.    separate host to the SpectroSERVER, provided that the
  174.    SPECTRUM CLI is installed on the same host as Orbit Star -
  175.     SPECTRUM. Compatabile versions of SpectroSERVER and
  176.  
  177.  
  178.  
  179. Smith                                                   FORMFEED[Page 3]
  180.  
  181.  
  182.  
  183.  
  184.  
  185. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  186.  
  187.  
  188.    SPECTRUM CLI can be on different Operating System platforms,
  189.    which implies that Orbit Star -  SPECTRUM can be deployed on
  190.    a different host operating system to that of the
  191.    SpectroSRVER.
  192.    2       The method that corresponds to the SPECTRUM Command Line
  193.    Interface (CLI) show attributes [mh=<model handle>]
  194.    attr=<attribute id>
  195.    3       This would be the same interface as invoked by the Orbit
  196.    Planet method in footnote 2.
  197.  
  198.    _5.  _P_r_o_t_o_c_o_l _D_e_f_i_n_i_t_i_o_n
  199.  
  200.    _5._1.  _F_r_a_m_e _S_t_r_u_c_t_u_r_e
  201.  
  202.    An Orbit Shadow protocol frame contains the fields set out in "Table
  203.    1 - Orbit Shadow Protocol Frame".
  204.  
  205.                       Field number   Field descriptor
  206.                       ______________________________________________________________
  207.                            0         version
  208.                            1         sequence
  209.                            2         command
  210.                            3         final
  211.                            4         platform
  212.                            5         interface
  213.                            6         database
  214.                            7         object
  215.                            8         attribute
  216.                            9         attribute type
  217.                            10        value
  218.  
  219.                    Table 1 - Orbit Shadow Protocol Frame
  220.  
  221.    Each of the fields in the protocol frame are described below.
  222.  
  223.    _5._1._1.  _V_e_r_s_i_o_n
  224.  
  225.    The field version identifies the revision of Orbit Shadow that is in
  226.    use. The field is an signed integer value with a length of eight (8)
  227.    bits.
  228.  
  229.    _5._1._2.  _S_e_q_u_e_n_c_e
  230.  
  231.    The field sequence is used ensure that information sent between the
  232.    Orbit Star and the Orbit Planet remains in sequence. The field is a
  233.    signed integer value with a length of thiry-two (32) bits.
  234.  
  235.  
  237.  
  238.  
  239. Smith                                                   FORMFEED[Page 4]
  240.  
  241.  
  242.  
  243.  
  244.  
  245. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  246.  
  247.  
  248.    _5._1._3.  _C_o_m_m_a_n_d
  249.  
  250.    The command field identifies the protocol action to be carried out by
  251.    the receipient of the protocol frame. The defined commands are
  252.  
  253.  
  254.             Command                Abbreviation   Integer Value
  255.             ______________________________________________________________________________________________________
  256.             authorise                  AUTH             0
  257.             request                    REQ              1
  258.             response                   RES              2
  259.             positive acknowledge       ACK              3
  260.             negative acknowledge       NACK             4
  261.             wait                       WAIT             5
  262.             terminate                  TERM             6
  263.  
  264.  
  265.                Table 2 -  Defined values for field: command
  266.  
  267.  
  268.    These commands are implemented in the protocol frame as a signed
  269.    integer value with a length of eight (8) bits.  Detailed examples of
  270.    the use of these commands is given in section "Protocol State Model".
  271.  
  272.  
  273.    _5._1._4.  _F_i_n_a_l
  274.  
  275.    The final field is a boolean flag, implemented as a single bit. This
  276.    flag is set to true (1) if the protocol frame is the last frame for
  277.    the specified command and is set to false (0) if the frame is not the
  278.    last frame in an exchange for a specified command. This flag is used
  279.    when sending bulk data in a request or a response.
  280.  
  281.  
  282.    _5._1._5.  _P_l_a_t_f_o_r_m
  283.  
  284.    The platform field defines the network or systems management platform
  285.    that Orbit Star interfaces with and is implemented as an signed
  286.    integer of length eight (8) bits. Currently defined values for plat-
  287.    form are
  288.  
  289.  
  290.   Value   Application              Platform                 Abbreviation
  291.   ____________________________________________________________________________________________________________________________________________
  292.   -128    Reserved                 -                        -
  293.    ..
  294.     -1    Reserved                 -                        -
  295.      0    Cabletron SPECTRUM       Command Line Interface   csiCLI
  296.      1    Cabletron SPECTRUM       SSAPI ver 4.0            csiSSAPI
  297.  
  298.  
  299.  
  300. Smith                                                   FORMFEED[Page 5]
  301.  
  302.  
  303.  
  304.  
  305.  
  306. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  307.  
  308.  
  309.   Value   Application              Platform                 Abbreviation
  310.   ____________________________________________________________________________________________________________________________________________
  311.      2    SunNET Manager           -                        sunNET
  312.      3    Sun Solstice             -                        sunENT
  313.               Enterprise Manager
  314.      4    HP Network Node          -                        hpNNM3
  315.              Manager ver 3.x
  316.      5    HP Network Node          -                        hpNNM4
  317.              Manager ver 4.x
  318.  
  319.                Table 3 - Defined values for field: platform
  320.  
  321.    _5._1._6.  _I_n_t_e_r_f_a_c_e
  322.  
  323.    The field interface defines the specific interface on the specified
  324.    platform that this protocol frame refers to and is implemented as a
  325.    signed integer eight (8) bits in length.  Interface values are unique
  326.    when used in conjunction with a specific platform value. Currently
  327.    defined values for the field "interface" are set out in Table 4. The
  328.    "interface" values for platform "csiCLI" use the typographical con-
  329.    ventions from the SPECTRUM "Command Line Interface User Guide".
  330.  
  331.  
  332.         Platform   Interface   Interface
  333.                      Value     Description
  334.         ______________________________________________________________________________________________________________________
  335.         csiCLI        000      reserved
  336.         csiCLI        001      connect [hostname]
  337.                                   [lh=landscape_handle]
  338.         csiCLI        002      disconnect
  339.         csiCLI        003      ack alarm aid=alarm_id
  340.                                   [lh=landscape_handle]
  341.         csiCLI        004      create alarm
  342.                                   cond=alarm_condition
  343.                                   cause=alarm_cause
  344.                                   mh=model_handle
  345.         csiCLI        005      create association
  346.                                   rel=relation
  347.                                   lmh=left_model_handle
  348.                                   rmh=right_model_handle.
  349.         csiCLI        006      create event
  350.                                   type=event_type
  351.                                   text=event_text
  352.                                   [mh=model_handle |
  353.                                   lh=landscape_handle ]
  354.         csiCLI        007      create model
  355.                                   mth=model_type_handle
  356.                                   [attr=attribute_id,
  357.                                   val=value ...]
  358.  
  359.  
  360.  
  361. Smith                                                   FORMFEED[Page 6]
  362.  
  363.  
  364.  
  365.  
  366.  
  367. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  368.  
  369.  
  370.         Platform   Interface   Interface
  371.                      Value     Description
  372.         ______________________________________________________________________________________________________________________
  373.                                   [lh=landscape_handle]
  374.         csiCLI        008      current [mh=model_handle |
  375.                                   lh=landscape_handle ]
  376.         csiCLI        009      destroy alarm [-n]
  377.                                   aid=alarm_id
  378.                                   [lh=landscape_handle]
  379.         csiCLI        010      destroy association [-n]
  380.                                   rel=relation
  381.                                   lmh=left_model_handle
  382.                                   rmh=right_model_handle.
  383.         csiCLI        011      destroy model [-n]
  384.                                   mh=model_handle
  385.         csiCLI        012      jump [text_string]
  386.         csiCLI        013      seek attr=attribute_id,
  387.                                   val=value
  388.                                   [lh=landscape_handle]
  389.         csiCLI        014      setjump [-n] text_string
  390.         csiCLI        015      show alarms [-x]
  391.                                   [mh=model_handle |
  392.                                   lh=landscape_handle ]
  393.         csiCLI        016      show associations
  394.                                   [mh=model_handle]
  395.         csiCLI        017      show attributes
  396.                                   [attr=attribute_id
  397.                                   [,iid=instance_id][,next]]
  398.                                   [attr=attribute_id
  399.                                   [,iid=instance_id][,next]...]
  400.                                   [mh=model_handle]
  401.         csiCLI        018      show attributes
  402.                                   mth=model_type_handle
  403.                                   [lh=landscape_handle]
  404.         csiCLI        019      show children [rel=relation]
  405.                                   [mh=model_handle]
  406.         csiCLI        020      show events  [-x]
  407.                                   [mh=model_handle |
  408.                                   lh=landscape_handle ]
  409.         csiCLI        021      show inheritance
  410.                                   mth=model_type_handle
  411.                                   [lh=landscape_handle]
  412.         csiCLI        022      show models [lh=landscape_handle]
  413.         csiCLI        023      show parents [rel=relation]
  414.                                   [mh=model_handle]
  415.         csiCLI        024      show relations [lh=landscape_handle]
  416.         csiCLI        025      show rules rel=relation
  417.         csiCLI        026      show types [lh=landscape_handle]
  418.         csiCLI        027      show landscapes
  419.  
  420.  
  421. Smith                                                   FORMFEED[Page 7]
  422.  
  423.  
  424.  
  425.  
  426.  
  427. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  428.  
  429.  
  430.         Platform   Interface   Interface
  431.                      Value     Description
  432.         ______________________________________________________________________________________________________________________
  433.         csiCLI        028      update  [mh=model_handle]
  434.                                   attr=attribute_id
  435.                                   [,iid=instance_id],val=value
  436.                                   [attr=attribute_id
  437.                                   [,iid=instance_id],val=value...]
  438.         csiCLI        029      update [-n]
  439.                                   mth=model_type_handle
  440.                                   attr=attribute_id,val=value
  441.                                   [attr=attribute_id,val=value...]
  442.                                   [lh=landscape_handle]
  443.  
  444.  
  445.                Table 4 - Defined values for field: interface
  446.  
  447.  
  448.  
  449.    _5._1._7.  _D_a_t_a_b_a_s_e
  450.  
  451.    The field database defines the target database on the platform for
  452.    which the interface is to be invoked, and is implemented as a signed
  453.    integer thirty two (32) bits in length.  This field is used when the
  454.    target platform supports distributed databases or has multiple data
  455.    sources. The usage of this field is dependant on the value of plat-
  456.    form.  The semantic definitions for database that are currently
  457.    defined are
  458.  
  459.  
  460.        Platform                        Semantic value of database
  461.        __________________________________________________________________________________________________________________________
  462.        csiCLI                          SPECTRUM VNM Landscape Handle
  463.        csiSSAPI                        SPECTRUM VNM Landscape Handle
  464.  
  465.  
  466.                Table 5 'Defined Values for field: database'
  467.  
  468.  
  469.    _5._1._8.  _O_b_j_e_c_t
  470.  
  471.    The field object defines an object in the "database" on the "plat-
  472.    form", and is implemented as an signed integer thirty two (32) bits
  473.    in length. The semantic value of object is specific for each plat-
  474.    form. The semantic definitions for object that are currently defined
  475.    are
  476.  
  477.  
  478.            Platform                    Semantic value of object
  479.  
  480.  
  481.  
  482. Smith                                                   FORMFEED[Page 8]
  483.  
  484.  
  485.  
  486.  
  487.  
  488. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  489.  
  490.  
  491.            __________________________________________________________________________________________________________
  492.            csiCLI                      SPECTRUM VNM model handle
  493.            csiSSAPI                    SPECTRUM VNM model handle
  494.  
  495.  
  496.                 Table 6 'Defined values for field: object'
  497.  
  498.  
  499.    _5._1._9.  _A_t_t_r_i_b_u_t_e
  500.  
  501.    The field attribute defines an attribute of an object, and is imple-
  502.    mented as a signed integer thirty two (32) bits in length. The seman-
  503.    tic value of attribute is specific for each platform. The semantic
  504.    definitions for object that are currently defined are
  505.  
  506.  
  507.        Platform                        Semantic value of attribute
  508.        __________________________________________________________________________________________________________________________
  509.        csiCLI                          SPECTRUM VNM attribute handle
  510.        csiSSAPI                        SPECTRUM VNM attribute handle
  511.  
  512.  
  513.                Table 7 'Defined values for field: attribute'
  514.  
  515.  
  516.    _5._1._1_0.  _A_t_t_r_i_b_u_t_e _T_y_p_e
  517.  
  518.  
  519.    The field "attribute type" describes the data type implemented by the
  520.    "attribute". This field is implemented as a signed integer eight (8)
  521.    bits in length.  The Orbit Shadow protocol uses primitive data types
  522.    as defined by Sun Microsystem's Java TM programming language. The
  523.    definition of these primitive data types can be found at
  524.  
  525.                           http://www.javasoft.com
  526.  
  527.  
  528.                          Field Value   Data type
  529.                          __________________________________________________
  530.                               0        Boolean
  531.                               1        Char
  532.                               2        Integer
  533.                               3        Long
  534.                               4        Float
  535.                               5        Double
  536.                               6        String
  537.  
  538.  
  539.             Table 8 'Defined values for field: attribute type'
  541.  
  542.  
  543. Smith                                                   FORMFEED[Page 9]
  544.  
  545.  
  546.  
  547.  
  548.  
  549. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  550.  
  551.  
  552.    _5._1._1_1.  _V_a_l_u_e
  553.  
  554.    The field value contains the data which is the value of the attribute
  555.    specified in the Orbit Shadow protocol frame, and is implemented as a
  556.    variable length sequence of bytes.
  557.  
  558.  
  559.    _5._2.  _P_r_o_t_o_c_o_l _S_t_a_t_e _M_o_d_e_l
  560.  
  561.    _5._2._1.  _O_v_e_r_v_i_e_w
  562.  
  563.    The exchange of Orbit Shadow frames between an Orbit Star and an
  564.    Orbit Planet is described by a series of data flow diagrams. Data
  565.    exchange between the Orbit Planet and Orbit Star is asynchronous and
  566.    bi-directional, and is always initiated by an Orbit Planet. For every
  567.    exchange that is initiated by an Orbit Planet, an Orbit Star will
  568.    reply with either a positive or negative acknowledgement. A session
  569.    between an Orbit Planet and an Orbit Star is initiated with a user
  570.    authentication exchange, followed by a sequence of requests and
  571.    responses. The session is not necessarily explicitly terminated, but
  572.    can be terminated by the Orbit Planet, or the Orbit Star.
  573.  
  574.  
  575.    _5._2._2.  _S_e_s_s_i_o_n _I_n_i_t_i_a_t_i_o_n
  576.  
  577.    A session between an Orbit Planet and an Orbit Star requires that
  578.    user authentication take place at least once, before any other
  579.    requests are serviced. If no authentication has occured, then the
  580.    Orbit Star will deny service to the Orbit Planet. Table 9 "Initial
  581.    state - no authorisation", shows the protocol exchange where an Orbit
  582.    Star denies service when no authentication has taken place.
  583.  
  584.  
  585.             Frame   Orbit Planet   Orbit Star   Frame detail
  586.             ______________________________________________________________________________________________________
  587.               1     REQ                         object=<..>,
  588.                                                 attribute=<..>,
  589.                                                 value=..
  590.  
  591.               2                    NACK         object=<..>,
  592.                                                 attribute=<..>,
  593.                                                 value=..
  594.  
  595.  
  596.                 Table 9 "Initial state - no authorisation"
  597.  
  598.  
  599.    An authorisation exchange is shown in Table 10 "Initial state -
  600.    authorisation exchange". In this exchange, both the user name and the
  601.  
  602.  
  603. Smith                                                  FORMFEED[Page 10]
  604.  
  605.  
  606.  
  607.  
  608.  
  609. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  610.  
  611.  
  612.    user password are accepted by the Orbit Star as valid.
  613.  
  614.  
  615.       Frame   Orbit Planet   Orbit Star   Frame detail
  616.       ____________________________________________________________________________________________________________________________
  617.         1     AUTH                        object=null,
  618.                                           attribute=<user name>,
  619.                                           value=user name
  620.         2                    ACK          object=<user object>,
  621.                                           attribute=<user name>,
  622.                                           value=user name
  623.         3     AUTH                        object=<user object>,
  624.                                           attribute=<user password>,
  625.                                           value=password
  626.         4                    ACK          object=<user object>,
  627.                                           attribute=<user password>,
  628.                                           value=password
  629.  
  630.  
  631.                 Table 10 "Initial state - authorisation exchange"
  632.  
  633.    If either the user name or user password is invalid, the Orbit Star
  634.    will send a negative acknowledgement of the authentication request.
  635.    An example of this is shown in
  636.  
  637.  
  638.       Frame   Orbit Planet   Orbit Star   Frame detail
  639.       ____________________________________________________________________________________________________________________________
  640.         1     AUTH                        object=null,
  641.                                           attribute=<user name>,
  642.                                           value=user name
  643.         2                    ACK          object=<user object>,
  644.                                           attribute=<user name>,
  645.                                           value=user name
  646.         3     AUTH                        object=<user object>,
  647.                                           attribute=<user password>,
  648.                                           value=password
  649.         4                    NACK         object=<user object>,
  650.                                           attribute=<user password>,
  651.                                           value=password
  652.  
  653.  
  654.              Table 11 "Initial state - authentication failure"
  655.  
  656.  
  657.    _5._2._3.  _R_e_s_q_u_e_s_t _A_n_d _R_e_s_p_o_n_s_e
  658.  
  659.    After the Orbit Planet has successfully identified the end-user to
  660.    the Orbit Star, requests for access to the Orbit Star platform
  661.  
  662.  
  663.  
  664. Smith                                                  FORMFEED[Page 11]
  665.  
  666.  
  667.  
  668.  
  669.  
  670. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  671.  
  672.  
  673.    interfaces can be made. On receiving a request, the Orbit Star will
  674.    acknowledge that the request is to be serviced, or refuse the request
  675.    through a negative acknowledgement. Table 12 "Request - service
  676.    refusal" shows the protocol exchange when the Orbit Star refuses to
  677.    service an Orbit Planet request.
  678.  
  679.  
  680.             Frame   Orbit Planet   Orbit Star   Frame detail
  681.             ______________________________________________________________________________________________________
  682.               1     REQ                         object=<..>,
  683.                                                 attribute=<..>,
  684.                                                 value=..
  685.               2                    NACK         object=<..>,
  686.                                                 attribute=<..>,
  687.                                                 value=..
  688.  
  689.  
  690.  
  691.                    Table 12 "Request - service refusal"
  692.  
  693.    Assuming that the Orbit Star is able to service the request from the
  694.    Orbit Planet, the exchange might be as set out in Table 13 "Request -
  695.    simple response".
  696.  
  697.  
  698.           Frame     Orbit Planet   Orbit Star     Frame detail
  699.          ________________________________________________________________________________________________________________
  700.             1       REQ                           object=<..>,
  701.                                                   attribute=<..>,
  702.                                                   value=..
  703.             2                      ACK            object=<..>,
  704.                                                   attribute=<..>,
  705.                                                   value=..
  706.          3          RES            object=<..>,
  707.                                                   attribute=<..>,
  708.                                                   value=..
  709.             4       ACK                           object=<..>,
  710.                                                   attribute=<..>,
  711.                                                   value=..
  712.  
  713.  
  714.                    Table 13 "Request - simple response"
  715.  
  716.  
  717.    _5._2._4.  _S_e_s_s_i_o_n _T_e_r_m_i_n_a_t_i_o_n
  718.  
  719.    To be completed.
  720.  
  721.  
  722.  
  723.  
  724.  
  725. Smith                                                  FORMFEED[Page 12]
  726.  
  727.  
  728.  
  729.  
  730.  
  731. RFC nnnn         Orbit Shadow - Protocol Specification     November 1996
  732.  
  733.  
  734.    _6.  _S_e_c_u_r_i_t_y _C_o_n_s_i_d_e_r_a_t_i_o_n_s
  735.  
  736.    There is a possible requirement for encryption of passwords in the
  737.    user authentication exchange in session initiation.
  738.  
  739.    _7.  _R_e_f_e_r_e_n_c_e_s
  740.  
  741.    _8.  _A_u_t_h_o_r'_s _A_d_d_r_e_s_s
  742.  
  743.  
  744.    Tony Gordon Smith
  745.    Gecko Software
  746.    17 Paragon Place
  747.    Blackheath
  748.    London
  749.    SE3 0SP
  750.    United Kingdom
  751.  
  752.    Phone:  +44-(0)700 0GECKO
  753.            +44-(0)700 043256
  754.    Fax:    +44-(0)700 740175
  755.    EMail:  tony@geckoware.com
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785. Smith                                                  FORMFEED[Page 13]
  786.  
  787.  
  788.