cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Colm O hEigeartaigh (Confluence)" <conflue...@apache.org>
Subject [CONF] Apache CXF Documentation > 3.0 Migration Guide
Date Thu, 15 May 2014 16:22:15 GMT
<html>
    <head>
        <meta name="viewport" content="width=device-width" />
        <base href="https://cwiki.apache.org/confluence" />
        <style type="text/css">
    body, #email-content, #email-content-inner { font-family: Arial,FreeSans,Helvetica,sans-serif;
}
    body, p, blockquote, pre, code, td, th, li, dt, dd { font-size: 13px; }
    small { font-size: 11px; }

    body { width:100% !important; -webkit-font-smoothing: antialiased; }

    body,
    #email-wrapper { background-color: #f0f0f0; }
    #email-wrapper-inner { padding: 20px; text-align: center; }
    #email-content-inner { background-color: #fff; border: 1px solid #bbb; color: $menuTxtColour;
padding:20px; text-align:left; }
    #email-wrapper-inner > table { width: 100%; }
    #email-wrapper-inner.thin > table { margin: 0 auto; width: 50%; }
    #email-footer { padding: 0 16px 32px 16px; margin: 0; }

    .email-indent { margin: 8px 0 16px 0; }
    .email-comment { margin: 0 0 0 56px; }
    .email-comment.removed { background-color: #ffe7e7; border: 1px solid #df9898; padding:
0 8px;}

    #email-title-avatar { text-align: left; vertical-align: top; width: 48px; padding-right:
8px; }
    #email-title-flavor { margin: 0; padding: 0 0 4px 0; }
    #email-title-heading { font-size: 16px; line-height: 20px; min-height: 20px; margin: 0;
padding: 0; }
    #email-title .icon { border: 0; padding: 0 5px 0 0; text-align: left; vertical-align:
middle; }

    #email-actions { border-top: 1px solid #bbb; color: #505050; margin: 8px 0 0 0; padding:
0; }
    #email-actions td { padding-top: 8px; }
    #email-actions .left { max-width: 45%; text-align: left; }
    #email-actions .right { text-align: right; }
    .email-reply-divider { border-top: 1px solid #bbb; color: #505050; margin: 32px 0 8px
0; padding: 8px 0; }
    .email-section-title { border-bottom: 1px solid #bbb; margin: 8px 0; padding: 8px 0 0
0; }

    .email-metadata { color: #505050; }

    a { color: #326ca6; text-decoration: none; }
    a:hover { color: #336ca6; text-decoration: underline; }
    a:active {color: #326ca6; }

    a.email-footer-link { color: #505050; font-size: 11px; }

    .email-item-list { list-style: none; margin: 4px 0; padding-left: 0; }
    .email-item-list li { list-style: none; margin: 0; padding: 4px 0; }
    .email-list-divider { color: #505050; padding: 0 0.35em; }
    .email-operation-icon { padding-right: 5px; }

    .avatar { -ms-interpolation-mode: bicubic; border-radius: 3px;}
    .avatar-link { margin: 2px; }

    .tableview th { border-bottom: 1px solid #69C; font-weight: bold; text-align: left; }
    .tableview td { border-bottom: 1px solid #bbbbbb; text-align: left; padding: 4px 16px
4px 0; }

    .aui-message {  margin: 1em 0; padding: 8px; }
    .aui-message.info { background-color: #e0f0ff; border: 1px solid #9eb6d4; }
    .aui-message.success { background-color: #ddfade; border: 1px solid #93c49f; }
    .aui-message.error,
    .aui-message.removed { background-color: #ffe7e7; border: 1px solid #df9898; color: #000;
}

    .call-to-action-table { margin: 10px 1px 1px 1px;}
    .call-to-cancel-container, .call-to-action-container { padding: 5px 20px; }
    .call-to-cancel-container { border: 1px solid #aaa; background-color: #eee; border-radius:
3px; }
    .call-to-cancel-container a.call-to-cancel-button { background-color: #eee; font-size:
14px; line-height: 1; padding: 0; margin: 0; color: #666; font-family: sans-serif;}
    .call-to-action-container { border: 1px solid #486582;  background-color: #3068A2; border-radius:
3px; padding: 4px 10px; }
    .call-to-action-container a.call-to-action-button { background-color: #3068A2; font-size:
14px; line-height: 1; padding: 0; margin: 0; color: #fff; font-weight: bold; font-family:
sans-serif; }

    /** The span around the inline task checkbox image */
    .diff-inline-task-overlay {
        display: inline-block;
        text-align: center;
        height: 1.5em;
        padding: 5px 0px 1px 5px;
        margin-right: 5px;
        /** Unfortunately, the negative margin-left is stripped out in gmail */
        margin-left: -5px;
    }

            @media handheld, only screen and (max-device-width: 480px) {
        div, a, p, td, th, li, dt, dd { -webkit-text-size-adjust: auto; }
        small, small a { -webkit-text-size-adjust: 90%; }

        td[id=email-wrapper-inner] { padding: 2px !important; }
        td[id=email-content-inner] { padding: 8px !important; }
        td[id="email-wrapper-inner"][class="thin"] > table { text-align: left !important;
width: 100% !important; }
        td[id=email-footer] { padding: 8px 12px !important; }
        div[class=email-indent] { margin: 8px 0px !important; }
        div[class=email-comment] { margin: 0 !important; }

        p[id=email-title-flavor] a { display: block; } /* puts the username and the action
on separate lines */
        p[id=email-permalink] { padding: 4px 0 0 0 !important; }

        table[id=email-actions] td { padding-top: 0 !important; }
        table[id=email-actions] td.right { text-align: right !important; }
        table[id=email-actions] .email-list-item { display: block; margin: 1em 0 !important;
word-wrap: normal !important; }
        span[class=email-list-divider] { display: none; }
    }



        </style>
    </head>
    <body style="font-family: Arial, FreeSans, Helvetica, sans-serif; font-size: 13px;
width: 100%; -webkit-font-smoothing: antialiased; background-color: #f0f0f0">
        <table id="email-wrapper" width="100%" cellspacing="0" cellpadding="0" border="0"
style="background-color: #f0f0f0">
            <tbody>
                <tr valign="middle">
                    <td id="email-wrapper-inner" style="font-size: 13px; padding: 20px;
text-align: center">
                        <table id="email-content" cellspacing="0" cellpadding="0" border="0"
style="font-family: Arial, FreeSans, Helvetica, sans-serif; width: 100%">
                            <tbody>
                                <tr valign="top">
                                    <td id="email-content-inner" align="left" style="font-family:
Arial, FreeSans, Helvetica, sans-serif; font-size: 13px; background-color: #fff; border: 1px
solid #bbb; padding: 20px; text-align: left">
                                        <table id="email-title" cellpadding="0" cellspacing="0"
border="0" width="100%">
                                            <tbody>
                                                <tr>
                                                    <td id="email-title-avatar" rowspan="2"
style="font-size: 13px; text-align: left; vertical-align: top; width: 48px; padding-right:
8px"> <img class="avatar" src="cid:avatar_9d57f4bd06048e7223da0909722fb7c3" border="0"
height="48" width="48" style="-ms-interpolation-mode: bicubic; border-radius: 3px" /> </td>
                                                    <td valign="top" style="font-size:
13px">
                                                        <div id="email-title-flavor" class="email-metadata"
style="margin: 0; padding: 0 0 4px 0; color: #505050">
                                                            <a href="    https://cwiki.apache.org/confluence/display/~coheigea@apache.org
" style="color:#326ca6;text-decoration:none;; color: #326ca6; text-decoration: none">Colm
O hEigeartaigh</a> edited the page:
                                                        </div> </td>
                                                </tr>
                                                <tr>
                                                    <td valign="top" style="font-size:
13px"> <h2 id="email-title-heading" style="font-size: 16px; line-height: 20px; min-height:
20px; margin: 0; padding: 0"> <a href="https://cwiki.apache.org/confluence/display/CXF20DOC/3.0+Migration+Guide"
style="color: #326ca6; text-decoration: none"> <img class="icon" src="cid:page-icon"
alt="" style="border: 0; padding: 0 5px 0 0; text-align: left; vertical-align: middle" />
<strong style="font-size:16px;line-height:20px;vertical-align:top;">3.0 Migration Guide</strong>
</a> </h2> </td>
                                                </tr>
                                            </tbody>
                                        </table>
                                        <div class="email-indent" style="margin: 8px 0
16px 0">
                                            <div class="email-diff">
                                                <div id="page-diffs" class="wiki-content">
                                                    <p class="diff-context-placeholder"
style="font-size: 13px">...</p>
                                                    <ul class="diff-block-target diff-block-context">
                                                        <li style="font-size: 13px">The
DefaultCryptoCoverageChecker now contains boolean properties to easily check if a WSS UsernameToken
was signed and/or encrypted. The default is now that a UsernameToken must be encrypted.</li>
                                                        <li style="font-size: 13px">
<span class="diff-html-added" id="added-diff-0" style="font-size: 100%; background-color:
#ddfade;">CXF 3.0.x picks up a new major version of Apache WSS4J (2.0.0). There are some
changes in this release which will impact on existing CXF users. These changes are extensively
summarized in the </span><a href="http://ws.apache.org/wss4j/migration.html" class="external-link"
rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-added"
style="font-size: 100%; background-color: #ddfade;">WSS4J 2.0.0 Migration Guide</span></a><span
class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">. The major
changes are as follows:</span> <br />
                                                            <ul>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">If
you have implemented a CallbackHandler to set/retrieve passwords for UsernameTokens/Signatures/Decryption/etc.,
then the namespace of the WSPasswordCallback Object has changed from &quot;org.apache.ws.security&quot;
to &quot;org.apache.wss4j.common.ext&quot;.</span> </li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">If
you have implemented a CallbackHandler to create SAML Assertions, then the namespace of the
SAML bean objects has changed from &quot;org.apache.ws.security.saml.ext&quot; to
&quot;org.apache.wss4j.common.saml&quot;.&nbsp;</span> </li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">WSS4J
1.6.x used a saml properties file to sign a SAML Assertion. This has been removed in WSS4J
2.0.0. Instead the SAMLCallback Object contains additional properties that can be set to sign
the Assertion. Please see the section entitled &quot;SAML Assertion changes&quot;
in the&nbsp;</span><a href="http://ws.apache.org/wss4j/migration.html" class="external-link"
rel="nofollow" style="color: #326ca6; text-decoration: none"><span class="diff-html-added"
style="font-size: 100%; background-color: #ddfade;">WSS4J 2.0.0 Migration Guide</span></a><span
class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> for more information
on this.</span> </li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">A
small number of configuration tags have been removed in WSS4J 2.0.0. Please see the section
entitled &quot;Removed Configuration Tags in WSS4J 2.0.0&quot; in the&nbsp;</span><a
href="http://ws.apache.org/wss4j/migration.html" class="external-link" rel="nofollow" style="color:
#326ca6; text-decoration: none"><span class="diff-html-added" style="font-size: 100%;
background-color: #ddfade;">WSS4J 2.0.0 Migration Guide</span></a><span
class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> for more information
on this.</span> </li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">The
default namespace for derived keys and secure conversation is now&nbsp; &quot;</span><span
class="nolink"><span class="diff-html-added" style="font-size: 100%; background-color:
#ddfade;">http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512</span></span><span
class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">&quot;.
The older namespace can be used instead via a new configuration tag.</span> </li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">The
RSA v1.5 Key Transport algorithm is no longer allowed by default. This can be changed via
a configuration tag.</span> </li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">Turning
off BSP (Basic Security Profile) Compliance (Basic Security Profile) on the outbound side
no longer has the effect of disabling the addition of a InclusiveNamespaces PrefixList when
signing a portion of the message. This is now controlled by a separate configuration tag in
WSS4J 2.0.0.</span> </li>
                                                            </ul> </li>
                                                        <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">In
addition to the changes above, CXF 3.0.0 fully supports the new streaming (StAX-based) </span><span
class="diff-html-changed" id="changed-diff-0" style="background-color: #d6f0ff;">WS-</span><span
class="diff-html-added" id="added-diff-1" style="font-size: 100%; background-color: #ddfade;">Security
implementation in WSS4J 2.0.0.</span> </li>
                                                        <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">To
switch to use the streaming code for the manual &quot;Action&quot; based approach,
simply change the outbound and inbound interceptors as follows:</span>
                                                            <ul>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">&quot;org.apache.cxf.ws.security.wss4j.WSS4JOutInterceptor&quot;
to &quot;org.apache.cxf.ws.security.wss4j.WSS4JStaxOutInterceptor&quot;.</span>
</li>
                                                                <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">&quot;org.apache.cxf.ws.security.wss4j.WSS4JInInterceptor&quot;
to &quot;org.apache.cxf.ws.security.wss4j.WSS4JStaxInInterceptor&quot;.</span>
</li>
                                                            </ul> </li>
                                                        <li style="font-size: 13px">
<span class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">For
the WS-SecurityPolicy based approach of configuring WS-Security, simply set the JAX-WS property
SecurityConstants.ENABLE_STREAMING_SECURITY (&quot;ws-security.enable.streaming&quot;)
to &quot;true&quot;. For more information on the streaming functionality available
in WSS4J 2.0.0, please see the </span><a href="http://ws.apache.org/wss4j/streaming.html"
class="external-link" rel="nofollow" style="color: #326ca6; text-decoration: none"><span
class="diff-html-added" style="font-size: 100%; background-color: #ddfade;">streaming documentation</span></a><span
class="diff-html-added" style="font-size: 100%; background-color: #ddfade;"> page of WSS4J.</span>
</li>
                                                    </ul>
                                                    <h4 id="id-3.0MigrationGuide-WS-ReliableMessaging"
class="diff-block-target diff-block-context"> <span class="diff-html-added" style="font-size:
100%; background-color: #ddfade;">WS-</span>ReliableMessaging</h4>
                                                    <p class="diff-block-context" style="font-size:
13px">&nbsp;</p>
                                                    <h4 id="id-3.0MigrationGuide-Majordependencychanges"
class="diff-block-context">Major dependency changes</h4>
                                                    <p class="diff-context-placeholder"
style="font-size: 13px">...</p>
                                                </div>
                                            </div>
                                        </div>
                                        <table id="email-actions" class="email-metadata"
cellspacing="0" cellpadding="0" border="0" width="100%" style="border-top: 1px solid #bbb;
color: #505050; margin: 8px 0 0 0; padding: 0; color: #505050">
                                            <tbody>
                                                <tr>
                                                    <td class="left" valign="top" style="font-size:
13px; padding-top: 8px; max-width: 45%; text-align: left"> <span class="email-list-item"><a
href="https://cwiki.apache.org/confluence/display/CXF20DOC/3.0+Migration+Guide" style="color:
#326ca6; text-decoration: none">View Online</a> </span> <span class="email-list-divider"
style="color: #505050; padding: 0 0.350em">&middot;</span> <span class="email-list-item"><a
href="https://cwiki.apache.org/confluence/plugins/likes/like.action?contentId=25203937" style="color:
#326ca6; text-decoration: none">Like</a> </span> <span class="email-list-divider"
style="color: #505050; padding: 0 0.350em">&middot;</span> <span class="email-list-item"><a
href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=25203937&amp;revisedVersion=38&amp;originalVersion=37"
style="color: #326ca6; text-decoration: none">View Changes</a> </span> </td>
                                                    <td class="right" width="50%" valign="top"
style="font-size: 13px; padding-top: 8px; text-align: right"> <span class="email-list-item"><a
href="https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=CXF20DOC"
style="color: #326ca6; text-decoration: none">Stop watching space</a> </span>
<span class="email-list-divider" style="color: #505050; padding: 0 0.350em">&middot;</span>
<span class="email-list-item"><a href="https://cwiki.apache.org/confluence/users/editmyemailsettings.action"
style="color: #326ca6; text-decoration: none">Manage Notifications</a> </span>
</td>
                                                </tr>
                                            </tbody>
                                        </table> </td>
                                </tr>
                            </tbody>
                        </table> </td>
                </tr>
                <tr>
                    <td id="email-footer" align="center" style="font-size: 13px; padding:
0 16px 32px 16px; margin: 0"> <small style="font-size: 11px"> This message was sent
by <a class="email-footer-link" style="color:#505050;font-size:11px;text-decoration:none;;
color: #326ca6; text-decoration: none; color: #505050; font-size: 11px" href="http://www.atlassian.com/software/confluence">Atlassian
Confluence</a> 5.0.3, <a class="email-footer-link" style="color:#505050;font-size:11px;text-decoration:none;;
color: #326ca6; text-decoration: none; color: #505050; font-size: 11px" href="http://www.atlassian.com/software/confluence/overview/team-collaboration-software?utm_source=email-footer">Team
Collaboration Software</a> </small> </td>
                </tr>
            </tbody>
        </table>
    </body>
</html>
Mime
View raw message