https://github.com/wmnsk/go-tcap
TCAP implementation in Golang.
https://github.com/wmnsk/go-tcap
3g mobile-protocol signaling sigtran ss7 tcap telco
Last synced: 20 days ago
JSON representation
TCAP implementation in Golang.
- Host: GitHub
- URL: https://github.com/wmnsk/go-tcap
- Owner: wmnsk
- License: mit
- Created: 2019-07-20T07:34:58.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-05T20:21:06.000Z (about 1 year ago)
- Last Synced: 2024-06-19T00:30:48.032Z (10 months ago)
- Topics: 3g, mobile-protocol, signaling, sigtran, ss7, tcap, telco
- Language: Go
- Size: 50.8 KB
- Stars: 36
- Watchers: 8
- Forks: 22
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-telco - go-tcap - Package tcap provides simple and painless handling of TCAP(Transaction Capabilities Application Part) in SS7/SIGTRAN protocol stack. (Protocols / SS7/SIGTRAN)
README
# go-tcap
Simple TCAP implementation in the Go Programming Language.
[](https://github.com/wmnsk/go-tcap/actions/workflows/golangci-lint.yml)
[](https://pkg.go.dev/github.com/wmnsk/go-tcap)
[](https://github.com/wmnsk/go-tcap/blob/master/LICENSE)
Package tcap provides simple and painless handling of TCAP (Transaction Capabilities Application Part) in SS7/SIGTRAN protocol stack, intended for Go developers to use.
## Disclaimer
Though TCAP is an ASN.1-based protocol, this implementation does not use any ASN.1 parser. That makes this implementation flexible enough to create arbitrary payload with any combinations, which is useful for testing while it also means that many of the features in TCAP are not supported yet.
This is still an experimental project, and currently in its very early stage of development. Any part of implementations(including exported APIs) may be changed before released as v1.0.0.
## Getting started
### Prerequisites
Run `go mod tidy` in your project's directory to collect the required packages automatically.
_This project follows [the Release Policy of Go](https://golang.org/doc/devel/release.html#policy)._
### Running examples
A sample client is available in [examples/client/](./examples/client/), which, by default, establishes SCTP/M3UA connection with a server sends a MAP cancelLocation.
```
Transaction Capabilities Application Part
begin
[Transaction Id: 11111111]
Source Transaction ID
oid: 0.0.17.773.1.1.1 (id-as-dialogue)
dialogueRequest
components: 1 item
Component: invoke (1)
invoke
invokeID: 0
opCode: localValue (0)
CONSTRUCTOR
CONSTRUCTOR Tag
Tag: 0x00
Length: 10
Parameter (0x04)
Tag: 0x04
Length: 8
Data: 00
GSM Mobile Application
Component: invoke (1)
invoke
invokeID: 0
opCode: localValue (0)
localValue: cancelLocation (3)
identity: imsi-WithLMSI (1)
imsi-WithLMSI
IMSI: 001010123456789
[Association IMSI: 001010123456789]
```
Some parameters can be speficied from command-line arguments. Other parameters including the ones in lower layers (such as Point Code in M3UA, Global Title in SCCP, etc.) should be updated by modifying the source code.
```
$ ./client -h
Usage of client:
-addr string
Remote IP and Port to connect to. (default "127.0.0.2:2905")
-opcode int
Operation Code in int. (default 3)
-otid int
Originating Transaction ID in uint32. (default 286331153)
-payload string
Hex representation of the payload (default "040800010121436587f9")
```
_If you are looking for a server that just can accept a SCTP/M3UA connection to receive a TCAP packet, [server example in go-m3ua project](https://github.com/wmnsk/go-m3ua/blob/master/examples/server/m3ua-server.go) would be a nice choice for you._
## Supported Features
### Transaction Portion
#### Message Types
| Message type | Supported? |
|----------------|------------|
| Unidirectional | |
| Begin | Yes |
| End | Yes |
| Continue | Yes |
| Abort | Yes |
#### Fields
| Tag | Supported? |
|----------------------------|------------|
| Originating Transaction ID | Yes |
| Destination Transaction ID | Yes |
| P-Abort Cause | Yes |
### Component Portion
#### Component types
| Component type | Supported? |
|--------------------------|------------|
| Invoke | Yes |
| Return Result (Last) | Yes |
| Return Result (Not Last) | Yes |
| Return Error | Yes |
| Reject | Yes |
### Dialogue Portion
#### Dialogue types
| Dialogue type | Supported? |
|-------------------------------------|------------|
| Dialogue Request (AARQ-apdu) | Yes |
| Dialogue Response (AARE-apdu) | Yes |
| Dialogue Abort (ABRT-apdu) | Yes |
| Unidirectional Dialogue (AUDT-apdu) | |
#### Elements
| Tag | Type | Supported? |
|-----------------------------|--------------|------------|
| Object Identifier | Structured | Yes |
| Single-ASN.1-type | Structured | Yes |
| Dialogue PDU | Structured | Yes |
| Object Identifier | Unstructured | |
| Single-ASN.1-type | Unstructured | |
| Unidirectional Dialogue PDU | Unstructured | |
## Author(s)
Yoshiyuki Kurauchi ([Website](https://wmnsk.com/))
## LICENSE
[MIT](https://github.com/wmnsk/go-tcap/blob/master/LICENSE)