chat.dim.stun.valus

Class XorMappedAddressValue

java.lang.Object

chat.dim.type.Data

chat.dim.tlv.values.RawValue

chat.dim.stun.valus.MappedAddressValue

chat.dim.stun.valus.XorMappedAddressValue

All Implemented Interfaces:

chat.dim.tlv.Value, chat.dim.type.ByteArray, java.lang.Cloneable

public class XorMappedAddressValue
extends MappedAddressValue

15.2. XOR-MAPPED-ADDRESS The XOR-MAPPED-ADDRESS attribute is identical to the MAPPED-ADDRESS attribute, except that the reflexive transport address is obfuscated through the XOR function. X-Port is computed by taking the mapped port in host byte order, XOR'ing it with the most significant 16 bits of the magic cookie, and then the converting the result to network byte order. If the IP address family is IPv4, X-Address is computed by taking the mapped IP address in host byte order, XOR'ing it with the magic cookie, and converting the result to network byte order. If the IP address family is IPv6, X-Address is computed by taking the mapped IP address in host byte order, XOR'ing it with the concatenation of the magic cookie and the 96-bit transaction ID, and converting the result to network byte order. The rules for encoding and processing the first 8 bits of the attribute's value, the rules for handling multiple occurrences of the attribute, and the rules for processing address families are the same as for MAPPED-ADDRESS. Note: XOR-MAPPED-ADDRESS and MAPPED-ADDRESS differ only in their encoding of the transport address. The former encodes the transport address by exclusive-or'ing it with the magic cookie. The latter encodes it directly in binary. RFC 3489 originally specified only MAPPED-ADDRESS. However, deployment experience found that some NATs rewrite the 32-bit binary payloads containing the NAT's public IP address, such as STUN's MAPPED-ADDRESS attribute, in the well-meaning but misguided attempt at providing a generic ALG function. Such behavior interferes with the operation of STUN and also causes failure of STUN's message-integrity checking.

Nested Class Summary

Nested classes/interfaces inherited from interface chat.dim.tlv.Value

chat.dim.tlv.Value.Parser<T extends chat.dim.tlv.Tag,L extends chat.dim.tlv.Length,V extends chat.dim.tlv.Value>

Nested classes/interfaces inherited from interface chat.dim.type.ByteArray

chat.dim.type.ByteArray.Helper

Field Summary

Fields inherited from class chat.dim.stun.valus.MappedAddressValue

family, FAMILY_IPV4, FAMILY_IPV6, ip, port

Fields inherited from class chat.dim.tlv.values.RawValue

ZERO

Fields inherited from interface chat.dim.type.ByteArray

helper

Constructor Summary

Constructors

Constructor and Description
XorMappedAddressValue(chat.dim.type.ByteArray data, java.lang.String ip, int port, byte family)

Method Summary

Modifier and Type	Method and Description
static XorMappedAddressValue	create(chat.dim.type.ByteArray data, chat.dim.type.ByteArray factor)
static XorMappedAddressValue	create(MappedAddressValue value, chat.dim.type.ByteArray factor)
static XorMappedAddressValue	create(java.lang.String ip, int port, chat.dim.type.ByteArray factor)
static XorMappedAddressValue	create(java.lang.String ip, int port, byte family, chat.dim.type.ByteArray factor)
static XorMappedAddressValue	from(XorMappedAddressValue value)
static chat.dim.tlv.Value	parse(chat.dim.type.ByteArray data, chat.dim.tlv.Tag tag, chat.dim.tlv.Length length)

Methods inherited from class chat.dim.stun.valus.MappedAddressValue

create, create, from, from, toString

Methods inherited from class chat.dim.tlv.values.RawValue

from, from, from

Methods inherited from class chat.dim.type.Data

clone, concat, concat, equals, equals, equals, equals, find, find, find, find, find, find, find, find, find, find, find, find, getBuffer, getByte, getBytes, getBytes, getBytes, getOffset, getSize, hashCode, mutableCopy, random, slice, slice, toHexString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface chat.dim.type.ByteArray

adjust, adjustE, concat, concat, concat, concat, equals, equals, equals, find, find, find, find, find, find, find, find, find, find, find, find, find, find, getBuffer, getByte, getBytes, getBytes, getBytes, getOffset, getSize, hexEncode, slice, slice, slice, slice, toHexString

Constructor Detail

XorMappedAddressValue

public XorMappedAddressValue(chat.dim.type.ByteArray data,
                             java.lang.String ip,
                             int port,
                             byte family)

Method Detail

from

public static XorMappedAddressValue from(XorMappedAddressValue value)

create

public static XorMappedAddressValue create(MappedAddressValue value,
                                           chat.dim.type.ByteArray factor)

create

public static XorMappedAddressValue create(chat.dim.type.ByteArray data,
                                           chat.dim.type.ByteArray factor)

create

public static XorMappedAddressValue create(java.lang.String ip,
                                           int port,
                                           byte family,
                                           chat.dim.type.ByteArray factor)

create

public static XorMappedAddressValue create(java.lang.String ip,
                                           int port,
                                           chat.dim.type.ByteArray factor)

parse

public static chat.dim.tlv.Value parse(chat.dim.type.ByteArray data,
                                       chat.dim.tlv.Tag tag,
                                       chat.dim.tlv.Length length)