Bug 704021

Summary: new SASL info for chapter 8
Product: Red Hat Enterprise MRG Reporter: mick <mgoulish>
Component: Messaging_Programming_ReferenceAssignee: Joshua Wulf <jwulf>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: high Docs Contact:
Priority: unspecified    
Version: 2.0CC: chetan, dryan, iboverma, lbrindle, lcarlon
Target Milestone: 2.2Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-09-20 03:13:24 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 733205    
Bug Blocks:    
Deadline: 2011-11-03   

Description mick 2011-05-11 20:49:52 UTC
( Thanks KennyG for noticing this omission. )

Chapter 8: Broker Federation
{
  We have a new capability that should be mentioned in the doco --
  the ability to create inter-broker (federated) routes with
  SASL security.

  SASL security can now be added to any type of route, using the
  new "mechanism" argument to qpid-tool.  It determines the SASL
  mechanism that will be used on the inter-broker connection.

  The new argument is avaailable in the following variants of the
  qpid-tool command:

     dynamic add
     route add
     queue add
     link add

  ( And it is listed in the qpid-tool help. )

  Please note that if you care enough to create secure inter-broker
  links, then you may also want the qpid-tool itself to use a 
  SASL-secured link when it is talking to the broker.  In that case,
  use the "--client-sasl-mechanism" argument, to determine which
  SASL mechanism qpid-tool will use.

}

Comment 2 Alison Young 2011-11-01 01:13:38 UTC
Updated flags and target milestone for 2.1

Comment 3 Alison Young 2011-11-01 02:25:50 UTC
Hi Mick,

qpid-tool is currently described in Ch12, Management Tools. Should it be relocated to Chapter 8 with the introduction of this new command, should these details actually be in Chapter 12 or just the above content put into chapter 8?

Thanks, 
Alison

Comment 4 mick 2011-11-02 20:18:56 UTC
I guess it has to be at least mentioned in the Management Tools section, because that's where you describe what the tool's arguments do.

But it should also be described in the chapter where we explain security -- and  that chapter is where you should mention the bit about "If you are using qpid-tool to make secure links, then you may also want qpid-tool itself to use a secure link with the --client-sasl-mechanism argument."

That's kind of serving-suggestion for how to use qpid-tool in a secure way, and has more to do with security than it does with qpid-tool.

Comment 8 mick 2012-04-09 17:18:51 UTC
Hi, sorry I missed this.

No, unfortunately qpid-tool does not as yet have any way to specify the SASL mechanism.  

It looks like I was just confused in comment 4, above.  I meant to say 'qpid-route'.

Comment 11 Cheryn Tan 2012-09-20 02:54:06 UTC
Released for MRG 2.2